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A TRUE SPREADSHEET 
CONTROL! 

(THIS IS NOT A GRID!) 


Drover’s Professional 
ToolBox for Windows 

With 23 custom controls, including Far- 
Point’s industry unique full-featured 
spreadsheet control (not a grid!), For¬ 
matted Edit Controls, Tool Bar and 
Status Bar, ability to add 3D effects to 
dialog boxes, View Pictures with anima¬ 
tion, and Enhanced Listbox this package 
is a developer’s dream come true. 

Over 300 functions are built in, including 
DOS System functions, Date/Time sup¬ 
port, String functions, and Enhanced file 
support. 

Drover’s Professional Toolbox supports 
MSC 7.0, Borland C + +, Turbo Pascal, 
Actor, WindowsMaker Pro, Borland 
Resource Workshop and Dialog Editor. 

Drover’s Professional Toolbox for Win¬ 
dows is only $345.00, There are no 
royalties and of course you receive our 
30 day no-hassle, money-back guar¬ 
antee. 



DON'T CHEAT YOUR END 
USER WITH A GRID WHEN 
YOU COULD BE GIVING THEM 
A TRUE SPREADSHEET 
CONTROL. 

FarPoint’s Spreadsheet control is unparalleled 
by any other package in its features, flexibility 
and power. The spreadsheet may be optionally 
locked so the user cannot make any changes. 
The width and height of columns and rows may 
be changed by the programmer or by the user. 
The font, color, and data type may be changed 
for any row, column or cell. Cells can have the 
following data types: edit, date, time, integer, 
float, static, formatted pic, combo box, button, 
and picture. Formulas can be added to any cell. 
Editing is performed within the cell. 

CALL OR FAX FARPOINT TODAY: 

( 614 ) 7654333 


Visual Architect M 

for Visual Basic 

“Visual Architect 7 ' 1 is a product 
that no serious Visual Basic devel¬ 
oper can do without.” 

Along with the industry’s 
most powerful and flexible 
true Spreadsheet custom 
control (not a grid!), Visual 
Architect™ features Date 
with Calendar, Time, Float, 

Integer, Formatted PIC and 
View Text controls. 

The Visual Architect™ 
manual is professionally writ¬ 
ten and contains extensive 
documentation. 

Visual Architect 1 ' is only $245.00. 
There are no roy alities and of course you 
receive our 30 day, no-hassle, money- 
back guarantee. 
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C CODE FOR THE PC 

source code, of course 

Embedded DOS (full-features, real-time, multitasking, 3.31-compatible DOS for embedded system and self-bootable installations).$375 

Style (a C+ + class library to build, maintain and traverse arbitrary, non-taxonomic links between C++ objects).$300 

Spell Time (spelling checker for incorporation into text products; no royalty; large dictionary; small and fast).$300 

ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 

INGRAF (graphics for scientists & engineers, all sorts of graphs & plots; specify Microsoft or Borland).$275 

The Snooper (Ethernet protocol analyzer for Novell NetWare and LAN Manager Networks; capture packets; real-time display).$275 

TUrbo'+X (Release 3.0; HP, PS, dot drivers; CM fonts; Lalj^C; MetaFont).$250 

Rogue Wave tools.h++ or math.h+-1- Class Library (extensive docs).each $240 

InControl 1bolbox(forms package for Windows; validation functions, dateAime, regular expression formatted text control).$195 

PxSQL (SQL for Borland’s Paradox Engine; ANSI X3.135-1989 SQL-DML standard; network server not required).$180 

c-pslib (PostScript generation library for C programs; includes complete graphics, font, rotation & paragraph support).$170 

C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, disk pager, database functions, much more).$170 

Viewpoint (C++ graphics library; 32-bit oolor, pattern fill, scroll & bitmap, coordinate tranformations).$170 

XASM (cross assemblers) .$150 

Minix Operating System (Version 1.5; Unfit-like operating system, includes manual; specify 5.25” or 3.5” diskettes).$150 

ViewTrieve (relational view of Novell Btrieve databases; includes EZTHeve).$150 

Updated! Delorie GCC for MS-DOS (Version 2.2.2, includes C++, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 

Booter Tbolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) .$120 

Dr. MD (runtime memory analyzer & debugger, find many memory corruption errors; examine memory usage).$110 

NEW! 386BSD Version 0.1 & LINUX Version 0.96 (two Unix clones for Intel 386).$100 

PC7IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

Demacs (complete GNU Emacs for DOS; needs djgce to build; based on 18.55).$100 

Script Interpreter (a command script interpreter for DOS-based systems; C-like script language; lots of features).$90 

NETS Version 3.0 (neural net simulator from COSMIC) .$85 

Ibrow (programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$85 

HorC++(C++Class Library for Borland’s Paradox Engine).$80 

NEW! ETNeural Net (back error propagation; specify DOS or windows).$75 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C++).$65 

LDB (Loose Data Binder; persistent data objects for C++; handles pointers between objects) .$60 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

NE W! PCCTS (Purdue Compiler Construction Tool Set; ported to Microsoft Q like YACC and LEX together with lots of additional features) . . . $60 
MEM-WING (global memory manager for Windows, supports standard C memory allocation calls to ’’wing” your old C code into Windows) . $55 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

EZ.CALC (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

NEW! Moby Crypto (encryption/decryption routines; Vol.l: DES, Lucifer, SRNG, ARNG; Vol. 2: PGP, RSA, MD4, SHA; both vols. $75) . . . each $50 

OBJASM (convert .obi files to .asm files; output is MASM compatible) .$50 

CLIPS Version 5.1 (rule-based expert system generator; advanced manuals available at additional cost).$50 

NIH Class Library & Book (basic C++ classes & Data Abstraction and Object-Oriented Programmingin C+ + in softback by Keith Gorlen) $50 

Updated! Editor Pack (20 public domain editors; microEmacs 3.11, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

MicroC C Compiler (retargetable C compiler/optimizer, lots of docs, very portable, 8086 tables included; tables for 7 extra epu’s $50) .... $50 

PICTOR (I/O library; windows, hypertext, text compression, serial comm, printer support, break handling; text editor example) .$45 

TOUR (beautiful traveling salesman problem solver, finds minimum length paths quickly, includes graphics & plotting programs) .$40 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; domestic distribution only) .... $40 

NEW! COPS (poor man’s C++; C macro package which implements C++ in C) .$35 

RXC & EGREP Version 20 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Database Pack (9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes C and C++ grammars) .$35 

NEW! PASSWORD (password-protect a running PC while you’re away from your desk; includes intrusion log) .$30 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

Alloc-GC (a garbage-collecting memory allocation library).$30 

REGX Plus (Version 20, search and replace string manipulation routines based on regular expressions).$30 

GNU Awk & Diff for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

Updated! UUPC Pack (UUCP for the PQ UUPC Version 1.11V, smail & snews) .$25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

FLEX (fast lexical analyzer generator; new, improved LEX; BSD Version 23.6 with docs) .$25 

GNU RCS (FSFs version of the Revision Control System; like Unix's SCCS only better; keeps track of software development).$20 

PCAL Personal Calendar (generates PostScript calendar for any month or year, lots of options, personalization file for your dates & schedule) $20 

Publisher’s Interchange Language (PIL Tool Kit, Version 5.0, API 20 by Quark) .$20 

NetCDF (Network Common Data Form; general-purpose data exchange for scientific data; many tools and programs available).$20 

NEW! CPP Pack (3 K&R Cpreprocessors).$20 

NEW! Bywater BASIC Version 1.10 (complete BASIC interpreter and interactive programming environment).$20 

Data 

Moby Thesaurus (25K root words, 1.2M synonyms).$350 

Moby Part-of-Speech (200,000 words and phrases described by prioritized part(s)-of-speech).$120 

Moby Words (500,000 words & phrases, 9,000 stars, 15,000 names).$80 

Moty Shakespeare (plays, sonnets, etc. ... every last word).$60 

Dictionary Word List (234,932 words in alphabetical order).$60 

Roget’s 1911 Thesaurus.$40 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; Africa, Asia, Europe, N. & S. America) $35 

The World Digitized (100,000 longitude/latitude of world country boundaries) .$30 

Lots ’O Words (160,086 German, 178,430 Dutch, 61,843 Norwegian, 60,453 Italian, 138,257 French, 53,142 English) .$30 

Text Pack (1990 CIA World Fact Book, Hacker’s Jargon File, Acronyma, Koran, Mormon Scriptures, One Liners, Mnemonics, more) .... $25 

CD-ROMs 

FontMaster Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB).$70 

Updated! InfoMagic (XI1R5, Ihhoe 4.3, complete GNU, ISODE, KA9Q & NCSA TCP/IP, Demacs, Djgcc, 386bsd, some GNU on Windows NT) . . . $70 

Prime Time Freeware (over 1 gigabyte of Unix C code).$60 

Walnut Creek Desktop Library (over 1,000 texts: Aesop, Shakespeare, Dickens, Doyle, Melville, dictionaries, word lists, thesaruses, etc.) . . $35 

Walnut Creek X11R5 and GNU (X11R5 with contributed and comp.sources_x, 120 GNU programs, SPARC executables).$35 

Walnut Creek Usenet and Simtel Unix-C (600MB).$35 

Whlnut Creek Simtel 20 MSDOS Archive (C source code but lots of other stuff too).$20 

The Austin Code Works Voice: (512) 258-0785 

11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-181,2 

Austin, Texas 78750-3587 USA E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 

□ Request 332 on Reader Service Card □ 
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Michael Schrage 
Author, “Shared Minds 
The New Technologies 
of Collaboration" 




migrating to graphical 
user interfaces in 


record numbers. Don't 
miss your chance to 
stay ahead of the pack! 


The Fourth Annual Winter 

Windows & OS/2 Conference 

January 20-22, 1993 (Tutorials: January 18 & 19) 

San Jose Convention Center, San Jose 


Featured Presentations 

♦ Keynote: The Myth of the Information 
Age: Creating Organizational Operating 
Systems by author Michael Schrage 

♦ Plenary by Fred Langa 

♦ Developer's Keynote 
by Gordon Eubanks 

♦ Strategy Briefings by representatives 
from both IBM and Microsoft 

Program Highlights 

♦ Over 35 Conference Sessions 

♦ An additional day of in-depth, full- 
day Tutorials 

♦ Private exhibits viewing and 
new *Napa Valley Wine Tour 


Technology Samplers, 90-minute sessions 
to bring you up-to-speed on the latest tech¬ 
nology advancements 
Corporate Applications Contest—Industry 
editors assess and judge the effectiveness of 
today’s outstanding applications 
* (Conference, Tutorial or Technology Sampler 
participants only) 


Please rush me information! 

Name 

fWDDjj 

Title 

Company 

Address 

City 

State 

Zip 

Tel 

Fax 



Fax or mail back the above info to receive updates and a full 
program brochure. FAX: (415) 905-2222. Mail to: Windows & 
OS/2 Conference, 600 Harrison Street, San Francisco, CA 94107 
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From 

the Editor 


A few years ago, when people heard I used C++ they would invariably ask if I thought it 
would replace C Nowadays, I rarely hear that question and I think I know why: a large percent¬ 
age of the software world no longer knows the difference between C and C++. One fascinating 
aspect of this phenomenon is the way in which the press drives it Managers read in the trades 
over and over that object-oriented software is the only hope for the future, so they decide to 
add “C++ experience" to their next job posting. Job-hunting programmers, noticing the increas¬ 
ing call for C++ programming (with no corresponding increase in job applicant testing) sit down 
with a compiler, write a few programs, and add “C++ experience" to their resumes. The 
similarity between the two languages gives the bogus C++ programmer a good chance of 
getting in the door. 

The PC C++ compiler industry has also contributed greatly to the overall mushing together 
of C and C++. The major PC compiler vendors ship their C and C++ compilers bundled together 
so tightly that, if you use the same file extension for both languages (as I do), you may spend 
twenty minutes (as I did) trying to find the option that lets you specify which language to use. 
In fact, Turbo C++ gave me my first concrete example of the language confusion to come. In his 
December, 1990 column in The C Users Journal, Ken Pugh received a letter from someone 
getting a compile error from “the Turbo C++" compiler. Neither Ken nor the reader stopped to 
ponder which language was being used (the compiler copyright always said “Turbo C++," even 
if the C compiler was being used), and the answer to the question was different, depending 
upon whether the reader had used C or C++I 

Of course, Ken’s column is about C, so it is understandable for him to assume he’s dealing 
with C code. On the other hand, on page 17 of the September, 1992 Microsoft Systems Journal, 
Richard Hale Shaw proclaims that “C++ is fully compatible with ANSI C and all of the features it 
inherits from C require compliance to the ANSI C standard.” Huh? As anyone who has to be 
concerned with language compatibility can tell you, C++ is "mostly* compatible with ANSI C, 
and that is not at all the same thing as “fully" compatible. For example, C and C++ have a bit of 
a disagreement over whether const int x-0; defines a local variable or a global variable. C++ 
offers a high degree of backward compatibility (otherwise, there would be no confusion), but it 
is still a distinct language. 

Lest you think it’s just PC magazines blurring the distinction, take a look at page 117 of the 
September, 1992 IEEE Software. There you will find a review of Advanced Windows Program¬ 
ming, by Martin Heller. The title of the book review (extrapolated from the content) is “Win¬ 
dows 3.1: Advanced Techniques and a Wealth of C++ Code." Huh? I try to keep tabs on who is 
dispensing C++ wisdom in print, and Martin Heller was not on my list In fact, Mr. Heller’s book 
intends to present C, not C++ source; since the code in his book works with Microsoft C v6.0 
(which did not contain a C++ compiler), the only C++ construct the code contained was “//" 
comments. Ironically, the book reviewer was technically correct in calling the code C++ since an 
ANSI compiler would reject the “//” comments, but woe to the programmer who buys the 
book hoping to find examples of using C++ classes in Windows programming. 

What's wrong with all this anyway? If someone wants to call C code C++ or call a C 
programmer a C++ programmer, why not? This is a free country, after all. Just beware when 
you are on the purchasing end of the transaction and, for goodness sake, make sure that you 
"decide* what language to write in rather than discover you’ve written C++ when you meant 
to write C To paraphrase an old TV sign-off: It's ten o'clock — do you know what language 
you’re programming in? 

Ron Burk 

Editor 

CIS: 70302,2566 ; BIX: rlburk-, Internet: ronb@rdpub.com ("...!uunet!rdpub!ronb") 
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For those of you sifting through dozens 
of conference invitations, Software 
Development ’93 has something you 
might like: everything. 

If you want to learn how to develop 
desktop systems cleanly, quickly and cost 
effectively, or if you manage the efforts 
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A Big Listbox 


Microsoft Windows provides a wealth of tools for creating unique, interesting, 
and functional applications. Unfortunately, the default control classes included with 
Windows, though functional, are neither unique nor interesting and have severe 
limitations. Particularly irritating is the fact that the default set of control classes 
can only operate on a maximum of 64Kb of data at one time. The 64Kb, single-seg¬ 
ment limitation, which affects edit controls, comboboxes, and listboxes — has 
plagued programmers since the first versions of Windows, and is still there today. 
Windows NT will finally do away with the problem, as the width of the data struc¬ 
tures has been widened to 32 bits and flat address space will become the norm. 
But until everyone converts to a 32-bit platform, or as long as people want to 
leverage their investment in 16-bit code, this limitation will exist. 

The 64Kb limitation is especially critical in the case of listboxes, because the 
number of string items that can be displayed in a listbox is directly proportional to 
the length of the strings. 1 have discovered a way to program around this 64Kb 
limitation and allow a greater number of very long strings to be handled in an 
OUNERDRAW-sty\e listbox. This work-around brings together four important aspects of 
programming for the Microsoft Windows environment: OUNERDRAU style controls, 
window subclassing, subsegment memory management, and custom controls. In 
this article I present an extended listbox control that works with standard and 
enhanced-mode Windows 3.0 and above, and handles as many as 8,160 entries, 
independent of the length of the strings. 


Listbox Styles and Their Limitations 

Listbox controls, whether created with a dialog editor or via a call to Create- 
Uindow(), are assigned the LBS_HASSTRINGS style by default. The LBS_HASSTRINGS 
listbox style implies that the control operates on items that are strings and that the 
strings are kept in the control's local heap segment along with data structures that 
define their order within the list. Typically, the strings maintained by a listbox con¬ 
sume more local heap space than the data structures that define their order. If it 
were possible to create a listbox control without the LBS_HASSTRINGS style and 
store the strings in global memory instead of local memory, all the extra local heap 
space could be used to increase the number of items. 

The only listboxes that don't have the LBS_HASSTRINGS style by default are 
those controls created with the LBS_OUNERDRAWFIXED and LBS_OUNERDRAUVARIABLE 
styles. Controls created with the LBS_OUNERDRAUFIXED and LBS_OMNERDRAMVARIABLE 
styles do not keep copies of the strings, but rather associate a 32-bit value with 
each entry in the listbox. This 32-bit value can be used to hold a far pointer to any 
type of object, a file offset, or even a handle and an 
offset to conform to the memory management require¬ 
ments of real-mode Windows. But, as the name implies, 
the owner of the control (the parent window) has to 
draw the listbox items by responding to some extra 
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Microsoft C/C++ v7.0 
Borland C++ v3.1 
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Custom Controls 


Custom Control 


Bruce Amos 


messages that the listbox generates. It is up to the programmer to maintain the 
objects — in this case, strings for display — in global memory and to paint those 
objects into the control's client area. While having to handle both global heap 
management and painting may seem burdensome, these tasks are really quite 
straightforward, and there is not a big performance penalty. Windows can give you 
quite a lot of help once you have become familiar with the data structures 
provided. If you encapsulate these extensions to a standard listbox control in a 
DLL, you’ll be able to extend existing applications without rewriting vast sections of 
code to handle both global memory allocation and the new OUNERDRAU messages. 

Subclassing 

By subclassing a listbox control, I can take advantage of the internal list 
management, control activation, and notification messages that listboxes already 
provide and thereby minimize the amount of code required for the work-around. 
As part of the OUNERDRAU design, Windows sends the OUNERDRAU messages to the 
parent window of any OUNERDRAU control. It seemed natural to structure my ex¬ 
tended listbox control to use a hidden, borderless parent window that would 
receive and handle the OUNERDRAW messages, while also passing along messages to, 
and echoing messages from, the subclassed listbox. This, in effect, hides the im¬ 
plementation of the control from any application that uses the control. Existing 
applications can be extended by changing one field in a dialog resource or by 
simply changing the class name parameter in CreateUindowf) calls. 

Most of my coding dealt with allocating global memory to store the strings and 
with supporting some of the retrieval, sorting, and searching messages that 
LBS_HASSTRINGS listboxes offer. I attempted to extend my control to make it act as 
if it had strings. 

In the subclassed window function, BigLB_SubProc() (see Listing 4) I intercept 
both LB_ADDSTRING and LB_INSERTSTRING to first allocate space for the parameter 
string in the global heap, and then make a copy of the parameter string in the 
control's global heap. The global pointer is substituted for the original calling 
parameter. The listbox takes care of maintaining the list by generating the ap¬ 
propriate draw and compare messages. 



Bruce Amos is President and Lead Programmer of Dimensional Software, Inc. He 
holds a BS in Computer Science from the New Mexico Institute of Mining and Tech¬ 
nology. He specializes in supporting small business computing with custom software, 
hardware advice, and promotes the development of"good computer karma." He can 
be reached at 518 School of Mines Rd., Socorro, NM 87801-4639, (505) 835-1516. 
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Listing 1 biglb.h — Header file for big listbox 


I* 

* Listing #1 — BIGLB.H (compile with medium model) 
*/ 

#include <windows.h> 


/* memory management constants */ 

/* these values allow 1 meg of string space */ 
#define MAXPAGES 128 
♦define PAGESIZE 8192L 


/* Note: if you are using Borland C++ v3.1, you must alter their 
custcntl.h as follows, change: 

♦ if Idefined(WINVER) || (WINVER < 0x030a) 
into: 

#if Idefined(WINVER) || (WINVER < 0x030a) && 
Idefined(STRICT) 

*/ 

♦include <custcntl.h> 

♦define LAST_LB_MSG (WM_USER+35) 


/* 

* Data structure used to access data 

* in the style dialog box function. 

* 

* this definition was apparently not included 

* in CUSTCNTL.H 

V 

typedef struct ( 

GLOBALHANDLE hCtlStyle; 

LPFNSTRTOID lpfnStrToId; 

LPFNIDTOSTR lpfnldToStr; 

) CTLSTYLEDLG, FAR +LPCTLSTYLEDLG, 

NEAR +NPCTLSTYLEDLG; 

♦include <ctype.h> 

♦include <string.h> 


/* extra window byte offsets */ 

♦define GWL_0LDPR0C 0 
♦define GWL_PAGETABLE 4 
♦define GWL CURRENT_PAGE 8 
♦define GWL”CURRENT_0FFSET 10 
♦define EXTRA WND BYTES 12 


/* style dialog ID's */ 


♦define 

ID 

IDNAME 

100 

♦define 

id" 

"notify 

101 

♦define 

id" 

"sort 

102 

♦define 

id" 

"redraw 

103 

♦define 

id" 

"lbts 

104 

♦define 

id" 

INTEG 

105 

♦define 

id" 

"multic 

106 

♦define 

id" 

"keyb 

107 

♦define 

id" 

"lbsb 

108 

♦define 

ID 

ATTS 

109 

♦define 

id" 

"group 

110 

♦define 

id" 

"vis 

111 

♦define 

ID 

"disa 

112 

♦define 

ID " 

"border 

113 

♦define 

ID 

VERTSB 

114 

♦define 

to; 

"horzsb 

115 

/* string table ID 

's */ 
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♦define BIGLB_STYLE_DLG 0 
♦define IDS_CTL_PR0P 1 
♦define IDS_C0NTR0L_NAME 2 
♦define IDS_SUBCLASS 3 

♦define IDS NOTIFY 16 
♦define IDS_S0RT 17 
♦define IDS_REDRAW 18 
♦define IDS LBTS 19 
♦define IDSJNTEG 20 
♦define IDS_MULTIC 21 
♦define 1DS_KEYB 22 
♦define IDS LBSB 23 
♦define IDS”STAND 24 


♦define BIGLB_DEFAULT_STYLE\ 

(LBS_STANDARD|WS_CHILD|WS_TABSTOP) 

extern HINSTANCE Modulelnstance; 

/* forward function delarations... */ 

LRESULT CALLBACK _export BigLBWndFn(HWND hWnd, 

UINT msg, 

WPARAM wParam, 
LPARAH 1Param); 

LRESULT CALLBACK _export BigLB_SubProc(HWND hWnd, 

UINT msg, 

WPARAM wParam, 
LPARAM 1Param); 

BOOL CALLBACK _export BigLBDlgFn(HWND hDlg, 

UINT msg, 

WPARAM wParam, 

LPARAM 1Param); 

LPSTR dll_malloc(HWND hWnd,DWORD len); 
void dll_freeall(HWND hWnd); 

/* End of File */ 
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LB_DELETESTRING messages are handled by default 
processing except for the last string in the list. Deleting the 
last string empties the listbox, so at that point I release the 
entire global heap. Similarly, handling an LB_RESETCONTENT 
releases the entire global heap. 

Other LBS_HASSTRINGS- style functionality that I support in¬ 
cludes LBJINDSTRING, LB_SELECTSTRING, and alphanumeric 
keyboard input to browse through the strings in the extended 
control. I had to implement these features myself. Since the 
LBSJASSTRINGS style and LBS_OUNERDRAW styles are mutually 
exclusive, and since the items contained in an OVERDRAW 
listbox may not be comparable (icons or bitmaps, for example) 


Listing 2 biglb.c - Main source code for big 
listbox 


finclude "bigib.h“ 

lifdef _B0RLANDC_ 

fpragma hdrstop 
#endif 


LRESULT CALLBACK _export BigLBWndFn(HWND hWnd, 

UINT msg, WPARAM wParam, LPARAM IParam) 

{ 

HDC hDC; /* note : no static data */ 

HWND hChild; 

TEXTMETRIC tm; 

RECT clRect; 

LPMEASUREITEMSTRUCT mis; 

LPCOMPAREITEMSTRUCT cis; 

/* LPDELETEITEMSTRUCT delis; */ 

LPDRAWITEHSTRUCT dis; 

LPCREATESTRUCT crs; 

HFONT hProp.hOldFont; 

FARPROC lpfnOldproc; 
char wrk[16]; 

BOOL handled = FALSE; 

/* deliver all listbox messages to ownerdraw control... */ 
if (GetWindow(hWnd,GW_CHILD) != NULL) 
if (msg >= LB_ADDSTRING && msg <= LAST_LB_MSG) 
return SendMessage(GetWindow(hWnd,GW_CHILD), msg, 

wParam,IParam); 

switch (msg) 

( 

case WM_CREATE : /* copy the styles and sizes */ 
crs = (LPCREATESTRUCT) IParam; 

/* to set a different font, pass a pointer 
to a font handle in Creat«Window() */ 
if (crs->lpCreateParams != NULL) 

{ 

hProp « *((HF0NT FAR *)crs->lpCreateParams); 
LoadString(ModuleInstance,IDS_CTL_PR0P,wrk,16); 
SetProp(hWnd,wrk,hProp); 

) 

else 

hProp = NULL; 

/* parent of OWNERDRAW listbox (not invisible, but 
behind the listbox without a border) */ 

SetWindowLong(hWnd,GWL_STYLE,WS_CHILD); 
hChild = CreateWindow(''LISTBOX", crs->lpszName, 
(crs->style | LBS_OWNERDRAWFIXED), 
crs->x,crs->x,crs->cx,crs->cy,hWnd,crs->hMenu, 
crs->hlnstance, crs->lpCreateParams); 
if (hProp != NULL) 

( 

/* change the font in the child */ 
SendMessage(hChild,WM_SETFONT,(WPARAM)hProp,NULL); 
/* clean up the property list */ 
LoadString(ModuleInstance,IDS_CTL_PR0P,wrk,16); 
RemoveProp(hWnd.wrk); 

) 
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Listing 2 continued 

if (hChild == NULL) 

NULL, 0, NULL); 

return -1L; 

/* if you don't need tab expansion, just draw the 

/* change LISTBOX's default wndproc 

* text with ExtTextOut */ 

* (save the old function pointer) */ 

DrawText(dis->hDC,(LPSTR)dis->itemData, 

IpfnOldproc = (FARPROC) SetWindowLong(hChild, 

lstrlen((LPSTR)dis->itemData), 

GWL WNDPROC, (LONG)BigLB SubProc); 

&dis->rcltem, (DT EXPANDTABS | DT LEFT | 

/* save the old address of the LISTBOX's wndproc 

DT NOCLIP I DT SINGLELINE | DT VCENTER)) 

* in window extra bytes of the BIGLB control... 

if (dis->itemState & ODS SELECTED) 

* rest of the extra bytes initialized to zero */ 

InvertRect(dis->hDC,&dis->rcltem); 

SetWindowLong(hWnd, GWL OLDPROC, (LONG)lpfnOldproc); 

if (dis->itemState & ODS FOCUS) 

handled = TRUE; 

DrawFocusRect(dis->hDC,&dis->rcItem); 

break; 

handled = TRUE; 

case WM DESTROY: /* clean up */ 

} 

hChild = GetWindow(hWnd,GW CHILD); 

/* if selecting, invert that line... 

SendMessage(hChiId,LB_RESETCONTENT,NULL,NULL); 

* (invert the old, and invert the new...) */ 

break; 

if (dis->itemAction & ODA SELECT) 

/* for OWNERDRAW listboxes, one must handle WM MEASUREITEM 

( 

* for creation (and drawing if style is 

InvertRect(dis->hDC,&dis->rcI tern) ; 

* LBS OWNERDRAWVARIABLE) WM COMPAREITEM for LB ADDSTRING 

handled = TRUE; 

* in a sorted listbox WM DRAWITEM for painting 

} 

* WM DELETEITEM when deleting a string, note: wParam means 

/* dis->itemID < 0 means the listbox is empty */ 

* something different under Windows 3.0 and Windows 3.1 

if (dis->itemAction & ODA FOCUS && 

* so don't look at it when servicing these messages!!! */ 

(int) dis->itemID >= 0) 

case WM MEASUREITEM: 

{ 

/* if wParam ** -1, the system is requesting the 

DrawFocusRect(dis->hDC,&dis->rcItem) ; 

* dimensions of an edit control in an owner draw 

handled = TRUE; 

* control, if wParam == 0, the measure message is 

) 

* being sent by a menu otherwise, wParam is the ID of 

RestoreDC(dis->hDC,-l); 

* the control that sent the WM MEASURE item message.*/ 

return (handled); 

mis - (LPMEASUREITEMSTRUCT) IParam; 

case WM COMMAND : 

LoadString(ModuleInstance,IDS CTL PROP.wrk, 16); 

/* echo notification messages to parent window */ 

hProp = (HFONT) GetProp(hWnd.wrk) ; 

return (SendMessage(GetParent(hWnd), WM COMMAND, 

hDC = GetDC(hWnd) ; 

GetWindowWord(hWnd,GWW ID), 

if (hProp != NULL) 

MAKELONG(hWnd, HIW0RD(1Param) ) )); 

hOldFont = (HFONT)SelectObject(hDC,hProp); 

case WM SIZE: /* resize the listbox */ 

GetTextMetrics(hDC,&tm); 

GetClientRect(hWnd,&clRect); 

if (hProp != NULL) 

MoveWindow(GetWindow(hWnd,GW CHILD), clRect.left, 

SelectObject(hDC,hOldFont); 

clRect.top, LOWORD(IParam), HIW0RD(1Param), TRUE); 

ReleaseDC(hWnd.hDC); 

break; 

/* give height of listbox line (of display font) */ 

case WM SETFONT: 

mis->itemHeight * tm.tmHeight; 

handled = TRUE; 

mis->CtlType = ODT LISTBOX; 

break; 

mis->CtlID = GetWindowWord(hWnd,GWW_ID) ; 

case WM SETFOCUS: 

return (TRUE); 

/* pass the focus along to the child LISTBOX */ 

case WM COMPAREITEM : 

SetFocus(GetWindow(hWnd,GW CHILD)); 

cis = (LPCOMPAREITEMSTRUCT) IParam; 

handled = TRUE; 

return lstrcmp((LPSTR) cis->itemDatal, 

break; 

(LPSTR) cis->itemData2) ; 

case WM SETREDRAW: 

/* 

/* pass the redraw state on to the child LISTBOX */ 

* This message is ignored because of the way 

return (SendMessage(GetWindow(hWnd,GW CHILD), 

* that global memory management works 

msg,wParam,IParam)) ; 

★ 

case WM ENABLE : 

* case WM DELETEITEM: 

/* ask for redraw when the enabled state changes. */ 

* delis * (LPDELETEITEMSTRUCT) IParam; 

case WM PAINT: 

* farfree((LPSTR)delis->itemData) ; 

/* fixes a re-draw error with Windows 3.0 */ 

* return (TRUE); 

InvalidateRect(GetWindow(hWnd,GW CHILD).NULL,TRUE); 

*/ 

break; 

case WM DRAWITEM : 

) 

dis = (LPDRAWITEMSTRUCT) IParam; 

if (handled) 

SaveDC(dis->hDC); 

return OL; /* message handled */ 

/* dis->itemData points to the string */ 

/* else, do the default processing... */ 

if (dis->itemAction & ODA DRAWENTIRE) 
f 

return DefWindowProc(hWnd,msg,wParam,1Param) ; 

i 

/* check for control enabled-ness */ 

) 

if (! IsWindowEnabled(hWnd) ) 


SetTextColor(dis->hDC, 

/* End of File */ 

GetSysColor(COLOR GRAYTEXT) ); 


/* fill the rectangle with the background color 


* (erases the old focus rectangle...) */ 


ExtTextOut(dis->hDC, dis->rcltern.left, 


dis->rcItem.top, ET0_0PAQUE, &dis->rcltem, 
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direct support for strings was left out of the OWNERDRAW listbox 
implementation. 

I generate my own LBN_SELCHANGE message for a success¬ 
ful LBJELECTSTRING. I use LB_SETCURSEL to change the actual 
selection, but LB_SETCURSEL does not, itself, generate a 
notification message. 

LBSJASSTRINGS listboxes and LBS_OUNERDRAU listboxes 
respond differently to some of the same messages. Normally 
an OUNERDRAW listbox responds to a WM_GETTEXT message by 
returning the 32-bit value associated with some item. An 
LBS_HASSTRINGS listbox responds to WM_GETTEXT by copying 
a string into a buffer. Similarly, an OUNERDRAW listbox responds 
to VMJGETTEXTLEN with 4 (the length of a 32-bit value), rather 
than with the length of the string, as an LBS_HASSTRINGS 
listbox does. The window function sub¬ 
classing implements LBS_HASSTRINGS- 
compatible return values for these mes¬ 
sages. 


the C library far memory management functions. 

Since the number of global handles is still limited under 
Windows 3.1, I implemented a simple subsegment memory 
allocation scheme to keep the number of global handles con¬ 
sumed by each control instance to a minimum. This was easi¬ 
ly accomplished by maintaining a local array — i.e., local to an 
instance of the control — of global handles or pages. I locked 
the handles so the subsegment allocation scheme could simp¬ 
ly hand out far pointers to string space. This implies that the 
control will only work in protected mode. Depending on the 
data you display, it may be advantageous to change the 
granularity of the heap. I chose a granularity of 128 8Kb pages, 
which provides space for around 1Mb of strings. 


Memory Management 

Implementing global memory 
management for the listbox strings re¬ 
quired some experimentation and 
thought. I first tried to use the C 
library's farmalloc() and farfreef) 
routines to allocate global memory and 
perform subsegment allocation, but this 
did not work the way I needed. 

When you allocate global memory in 
a DLL via GlobalAlloc(), that global 
memory becomes sharable among all 
other programs that use the DLL. The 
global memory itself is not owned by 
the DLL, but rather by the program that 
called the DLL. The DLL’s runtime library 
start-up code initializes a set of 
pointers, stored in the DLL’s local heap, 
that are used to maintain a global heap. 
Consequently, all programs that call the 
DLL to do global memory allocation are 
using the same global heap. 

The library memory management 
functions work well until you shut 
down one of several application instan¬ 
ces that are sharing the custom control. 
When an application instance shuts 
down, Windows deallocates all of the 
global memory consumed by that in¬ 
stance. This has the side effect of leav¬ 
ing deallocated holes in the heap that 
the DLL maintains for all the other con¬ 
trols. The next memory access by any 
remaining control instance is likely to 
point to a deallocated block, causing an 
unrecoverable application error (the 
dreaded UAE). So sharing a single global 
heap among multiple control instances 
won’t work, and this precludes using 


Your future^ 
These Windows.^ 





CUR _backs pace <) 


CUfi_de lete O 

»»»»»»»»»»»»»»»»»»»»»»»»»»» 

CUA_cut< void ) 


(include <ctype.h> 

(include cstdlib h> 

(include exports, h" 

(include startup. IV’ 

ne HAX_BUF_SIZE 2SB 

static void printf_aessage( LPS7R fat. 

static BOOL translatef uoid )-. 
static BOOL 9*areh( uoid ); 

static tony do_translation( LPSTR pattern. LPSTR replacement ; 
static long scrap Qfseration( BOOL cutting ). 
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In order to make each heap local to each control, I Ui 
reserved space using the extra window bytes in the control Uc 
class definition to hold the necessary pointers and counters 
that define the state of each control's global heap. These extra ar 

bytes are assignable using the SetUindowUord() and Set- ac 

Listing 3 dll_mem.c - Memory management for big listbox 


WindowLongO functions and accessible using GetUindow- 
Uord() and GetUindowLong() functions. 

The dll_malloc() function (Listing 3), called in response to 
an LB_ADDSTRING or an LB_INSERTSTRING message, always 
advances through memory, allocating new 8Kb pages when 


linclude “biglb.h” 

#ifdef _BORLANDC_ 

#pragma hdrstop 
#endif 

LPSTR dll_ma 11oc(HWND hWnd,DWORD len) 

{ 

/* cast this FAR */ 

LPSTR (FAR *page_table); 

LPSTR retval; 

WORD current_offset; 

WORD current_page; 

/* too long or too short for a page... */ 
if (len > PAGESIZE 11 len == OL) 
return NULL; 

page_table=(LPSTR FAR *)GetWindowLong(hWnd,GWL_PAGETABLE); 
current_page = GetWindowWord(hWnd,GWL_CURRENT_PAGE); 
current_offset * GetWindowWord(hWnd,GWL_CURRENT_OFFSET); 
if (page_table »« NULL) 

1 

/* first call, allocate the page_table... */ 
page_table = (LPSTR FAR *) 

Global Lock(G1obalA11oc(GMEM_MOVEABLE|GMEM_ZEROINIT, 
(DWORD) MAXPAGES * sizeof(LPSTR))); 
if (page_table ** NULL) 
return NULL; 
current_offset » 0; 
current_page * 0; 
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/* allocate the first page */ 
if ((page_table[current_page] = (LPSTR) 

G1obalLock(G1obalA11oc(GMEM_M0VEABLE|GMEM_ZER0INIT, 
(DWORD) PAGESIZE))) == NULL) 
return NULL; 

retval = page_table[current_page]; 
current_offset +« (WORD) len; 

} 

else /* some wasted space at the end of a page */ 
if ((DWORD)current_offset+(DW0RD)1en > PAGESIZE) 

( 

/* allocate a new page... */ 
if (++current_page *= MAXPAGES) 
return NULL; 
current_offset 1 0; 

if ((page_table[current_page] ■ (LPSTR) 

GlobalLock(Gl obalAl loc(GMEM_MOVEABLE|GMEM_ZEROINIT, 
(DWORD) PAGESIZE))) — NULL) 

return NULL; 

retval * page_table[current_page]; 
current_offset +« (WORD) len; 

) 

else 

( 

retval * &page_table[current_page][current_offset]; 
current_offset +* (WORD) len; 

) 

/* stash the updated values... */ 

SetWindowLong(hWnd, GWL_PAGETABLE, (DWORD)page_table); 
SetWindowWord(hWnd, GWL_CURRENT_PAGE, current_page); 

SetWindowWord(hWnd, GWL_CURRENT_OFFSET, current_offset); 
return retval; 

) 

void dll_freeall(HWND hWnd) 

{ 

/* cast this FAR */ 

LPSTR (FAR *page_table); 

WORD current_offset; 

WORD current_page; 
int i; 

GLOBALHANDLE gh; 

page_table=(LPSTR FAR *)GetWindowLong(hWnd,GWL_PAGETA8LE); 
current_page = GetWindowWord(hWnd, GWL_CURRENT_PAGE); 
current_offset * GetWindowWord(hWnd, GWL_CURRENT_OFFSET); 

if (page_table »• NULL) /* already freed */ 
return; 

i = 0; 

while (page_table[i] != NULL && i < MAXPAGES) 

( 

gh = (GLOBALHANDLE) 

G1obalHandle(HIWORD(page_table[1++])); 
GlobalUnlock(gh); 

GlobalFree(gh); 

) 

gh=(GLOBALHANDLE)G1obalHandle(HIW0RD((LPSTR)page_table)); 
GlobalUnlock(gh); 

GlobalFree(gh); 
page_table = NULL; 
current_page = 0; 
current_offset = 0; 

/* stash the updated values... */ 

SetWindowLong(hWnd, GWL_PAGETABLE,(LONG)page_table); 

SetWindowWord(hWnd, GWL_CURRENT_PAGE,current_page); 

SetWindowWord(hWnd, GWL CURRENT OFFSET,current offset); 

) 

/* End of File */ 
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necessary to satisfy a memory request, when dll_malloc() 
is called, it first extracts the state of the heap from the ex¬ 
tended listbox’s extra window bytes. The state of the heap is 
defined by a pointer to an array of global handles or pages, a 
current page counter, and an offset into the current page. 

Listing 4 


dll_malloc() makes the allocation by saving a pointer to the 
current location in the heap and then adding the length of the 
string, plus one, to the offset in the current page. The current 
page counter is incremented whenever a new page is allocated. 
If the memory request is larger than the bytes remaining in the 


Ibsubpro.c - Listbox subclass function for big listbox 


finclude "bigib.h" 

#ifdef _BORLANDC_ 

fpragma hdrstop 
#endif 

LRESULT CALLBACK _export BigLB_SubProc(HWND hWnd, 

UINT msg, WPARAM wParam, LPARAM IParam) 

{ 

LPSTR lpc; 

LRESULT 1 result; 

WORD st,count,org_st,len; 

BOOL found,wrapped; 
char wrk[2]; 

switch (msg) 

f 

case WM_CHAR: 

/* position in listbox according to keyboard input */ 
if (isalnum(wParam) || ispunct(wParam)) 

{ 

wrk[0] = wParam; 
wrk[l] * 0; 

st = (WORD) SendMessage(hWnd, 

LB_GETCURSEL,NULL,NULL); 

/* LB_SELECTSTRING will change the 
selection if prefix is found */ 

1 result = SendMessage(hWnd, LB_SELECTSTRING, 
st, (LPARAM) (LPSTR)wrk); 
return (TRUE); 

) 

break; 

case LB_$ELECTSTRING: 
case LB_FINDSTRING: 

st = wParam; /* starting position */ 

/* -1 for start at the beginning... */ 
if (st == OxFFFF) 
st « 0; 
else 
st++; 

/* save the value to detect a wrap-around */ 
org_st = st; 

1 result - SendMessage(hWnd, LB_GETCOUNT,NULL,NULL); 
if (1 result == LB_ERR) 
return LB_ERR; 
count = (WORD) 1 result; 
found » wrapped = FALSE; 
len = lstrlen((LPSTR) IParam); 
while (!found) 

{ 

while (st < count) 

( 

/* fetch a pointer to the start string */ 
lresult » CallWindowProc( 

(WNDPROC)GetWindowLong( 

GetParent(hWnd),GWL_0LDPR0C), 
hWnd,LB_GETTEXT,st,(LPARAM)(void FAR *)&lpc); 
if (lresult *= LB_ERR) 
return LB_ERR; 

/* this works for COMPACT model, pointers are 
* the correct width for strncmp() */ 
if ( fstrncmp(lpc,(LPSTR) 1 Param,len)==0) 

( 

found = TRUE; 
break; 

) 

st++; 

) 

/* wrap the search... */ 
if ([wrapped && !found) 


( 

st = 0; 

wrapped = TRUE; 

/* if I wrapped, and I started at the begining */ 
if (wParam == OxFFFF) 
return LB_ERR; 
count » org_st; 

) 

else 

break; /* no match or found */ 

) 

if (wrapped && !found) 
return LB_ERR; /* not found... */ 

/* LB_FINDSTRING does not change the selection */ 
if (msg == LB_SELECTSTRING) 

( 

/* generate a notification message */ 

SendMessage(GetParent(hWnd), 

WM_COMMAND, GetWindowWord(hWnd,GWW_ID), 
MAKELONG(hWnd,LBN_SELCHANGE)); 

/* now change the selection LB_SETCURSEL does not 
* generate a notification message */ 

SendMessage(hWnd, LB SETCURSEL, (WORD) st .NULL); 

) 

return (LPARAM) st; 

/* intercept and allocate listbox string space globally */ 
case LBJNSERTSTRING : 
case LB ADDSTRING : 
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Listing 4 continued 


if ((1 pc * (LPSTR) dll_mal1oc(GetParent(hWnd), 

1strlen((LPSTR)lParam)+1L)) == NULL) 
return (LB_ERRSPACE); 

IParam = (LPARAM)lstrcpy(lpc,(LPSTR)lParam); 
break; 

case LB_GETTEXT: 

lresult = CallWindowProc((WNDPROC)GetWindowLong( 
GetParent(hWnd),GWL_OLDPROC), 
hWnd.msg.wParam,(LPARAM)(void FAR *)&lpc); 
if (lresult == LB_ERR) 
return LB_ERR; 
lstrcpy((LPSTR)l Param.l pc); 
return lstrlen(lpc); 
case LB_GETTEXTLEN: 

lresult = CallWindowProc((WNDPROC)GetWindowLong( 

GetParent(hWnd),GWL_0LDPR0C), hWnd,LB_GETTEXT, 
wParam,(LPARAM)(void FAR *)&lpc); 
if (lresult == LB_ERR) 
return LB_ERR; 

return (LPARAM) 1strlen(lpc); 


/* call the old LISTBOX callback function to process most 

* of the messages, the old wndproc address is stored in 

* the parent's extra window bytes */ 

lresult * CallWindowProc((WNDPROC)GetWindowLong( 

GetParent(hWnd),GWL_OLDPROC),hWnd,msg,wParam,lParam); 
if (msg == LB_RESETCONTENT) 
dll_freeal1(Get Parent(hWnd)); 
if (msg == LB_DELETESTRING && 

SendMessage(hWnd,LB_GETCOUNT,0,OL) == OL) 
dll_freeal1(GetParent(hWnd)); 
return lresult; 

1 

/* End of File */ 
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current page, the code allocates a new page. Similarly, if the 
string is NULL or larger than a whole page, or if the maximum 
number of pages is exceeded, memory allocation fails. The up¬ 
dated values are then stored back in the extra window bytes. 
Since each instance of the extended control has its own extra 
window bytes, each instance of the control has its own heap. 

I do not provide a mechanism to compact the heap when 
items are deleted. I do, however, provide a mechanism, 
dll_freeall(), to free global memory when the extended 
listbox becomes empty or is emptied explicitly by the 
processing of an LB_RESETCONTENT message. dll_freeall() 
simply extracts the current state of the heap and advances 
though the global handle table freeing each page. The offset 
into the current page, the page counter, and the table pointer 
are all then set to NULL and stored back in the extra window 
bytes, ready for new allocation. This implementation works 
fairly well, as it requires little overhead, and can easily be 
rationalized by the assumption that if you have more than 
8,000 strings to display, you probably have lots of memory in 
your machine to begin with. 

Drawing the Extended Control 

0NNERDRAN controls require that the parent window 
process some extra messages: WM_MEASUREITEM, NM_DRANITEM, 
NM_C0MPAREITEM, and NM_DELETEITEM. The listbox generates 
these messages when it needs to create, draw, sort data, or 
remove data from any 0NNERDRAN control. 

The first 0NNERDRAN message is NM_MEASUREITEM. When an 
LBSJDNNERDRANFIXED control is created, NM_MEASUREITEM is 
sent initially to the parent window to obtain information 
about the size of the items and about the type of the 
ON NERD RAN control. The parent window must respond by filling 
in a MEASURE ITEM structure with the height of the items that 
will be displayed, the type of the ownerdrawn control, and an 
ID that references the control. In this case, the item height is 
the height of the font that will be used to display the strings, 
and the type is 0DT_LISTB0X. Finally, the ID of the control is a 
known constant, and can be the same ID used by the applica¬ 
tion when requesting the control creation. Windows provides 
a far pointer to the MEASUREITEM structure in the LPARAM 
message parameter. If the LBSJONNERDRANVARIABLE style is 
used, the parent window will receive a NM_MEA SURE I TEM mes¬ 
sage for each item that needs to be drawn. Under Windows 
3.1, it is only necessary to handle the initial NM_MEASUREITEM 
message if you want to change the default size of the items. 
The default height is the height of the system font. Windows 
fills in the rest of the necessary information from the window 
creation parameters. 

The next 0NNERDRAN message is NM_DRANITEM. Whenever 
the listbox has to redraw the control — whether because the 
control was scrolled or uncovered, or because an item was 
selected, or because the control acquired or lost the input 
focus — the listbox sends a NM_DRANITEM message to the 
parent window for each item to be redrawn. Windows 
provides a pointer to a DRANITEM structure, again in the 
LPARAM message parameter. This structure contains a handle 
to a display context, the 32-bit value associated with the item 
in the listbox (in this case a pointer to a string), a set of flags 
that determine how the item should be drawn, a rectangle 
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Figure 1 A big listbox in action 


File Edit Generate til Full 


Help 
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19143 NINETEEN THOUSAND ONE HUNDRED FORTY THREE 
21503 TWENTY ONE THOUSAND FIVE HUNDRED THREE 
25352 TWENTY FIVE THOUSAND THREE HUNDRED FIFTY TWO 


Toggle LB Enable 


Current Selection is : 


Item number: 2 String : 09596 NINE THOUSAND FIVE HUNDRED NINETY SIX 


that bounds the area that needs to be painted, and the index 
of the listbox item in the itemlD field. In the case of an empty 
listbox, itemlD is a negative number. The DRAUITEM structure 
also includes a control type field, but since there is only one 
control that could be sending OUNERDRAU messages, this field 
can be ignored. The location within the control's client area 
and the data to display are both straightforward. The flags 
that determine how the item should be drawn, however, re¬ 
quire a little more consideration. 

The flags are bitmapped and are divided into two sets. One 
set reflects an action in progress and one set reflects the cur¬ 
rent state of a given listbox item. The action bits, mapped into 
the itemAction field of the DRAWITEM structure, include 
ODA_DRAMENTIRE, ODAJOCUS, and ODAJELECT. If the 
ODA_DRAWENTIRE bit is set, the entire control must be drawn 
and the text must be output along with any focus and selec¬ 
tion attributes. Multiple action flags can be set to be handled 
by a Single UM_DRAUITEM message. The ODA_DRAMENTIRE flag 
can be combined with the 0DA_F0CUS and ODA_SELECT flags 
when drawing the item that is the current selection. If the 
0DA_F0CUS bit is set, the control is either gaining or losing the 
input focus, which means that the focus rectangle should be 
drawn using the rcltem field provided. When the focus or the 
selection is changing Windows sends a UM_DRAUITEM message 
for the item that must be changed. If the ODA_SELECT bit is 
set, an item is being selected, and thus should be shown in an 
inverted color scheme. When the selection is changing, Windows 
sends a WM_DRAUITEM message with the ODA_SELECT bit set both 
for the item being selected and for the item being deselected. 

The state bits, mapped in the itemState field, include 
ODS_DISABLED or 0DS_GRAYED, ODSJOCUS, and 0DS_SELECT. 
The state flags reflect the current state of an item in the con¬ 
trol. By examining both the action bits and the state bits I can 
draw the proper display colors and focus rectangle. To avoid 
redraw errors, I make sure that the entire rectangle in the 
DRAM ITEM structure is filled with the background color, before I 
draw any text in it. I first call ExtTextOut() with a NULL string 


and the 0DT_0PAQUE flag set, thus filling the rectangle with the 
background color and then call DrawText() with the DT_EX- 
PANDTABS flag set, in case there are tabs that need expanding. 
To draw the focus rectangle, I simply call DrawFocusRect() to 
XOR in a dashed rectangle. When l need to draw the control in 
its disabled state, with gray text, I test for window-enabled 
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directly with a call to IsUIndowEnabled() since the 0DS_DIS- 
ABLED flag seems to apply to a single item and not to the 
entire listbox. 

I draw each item as quickly as possible because redraws 
require handling a separate UM_DRAUITEM message for each 
visible item. If the listbox's window is physically large, redraws 
tend to slow down considerably. Similarly, when drawing 
LBS_OUNERDRAWVARIABLE controls, handling the extra 
MM_MEASUREITEM for each item starts to cut into performance. I 
don't recommend the OUNERDRAWVARIABLE style unless your 


application absolutely demands it To facilitate more complex 
drawing, I use SaveDC() and RestoreDC() to eliminate the 
extra calling overhead incurred by replacing all the old pens, 
brushes, and bitmaps. I use SaveDC(hDC) and RestoreDC(hDC,- 
1) first to push the device context's current state onto the 
display context stack and then to restore it. 

The hidden parent window processes the WM_COMPAREITEM 
message to determine the proper insertion location of a 
newly added item. Windows provides a pointer to a COM¬ 
PARE ITEM structure that contains two pointers to listbox items 


Listing 5 dlgedit.c — Dialog editor interface for big listbox 

finclude "bigib.h" 

LoadString(Modulelnstance, IDS CONTROL NAME, 

#ifdef BORLANDC 

(LPSTR) &lpCtlInfo->szClass, CTLCLASS); 

fpragma hdrstop 

LoadString(ModuleInstance, IDS CONTROL NAME, 

Ipragma argsused 

(LPSTR)&1pCtlInfo->szTitle, CTLTITLE); 

#endif 

wNumTypes * lpCtlInfo->wCtlTypes; 

/* checking for too many control types */ 

HINSTANCE Modulelnstance; 

if (wNumTypes == CTLTYPES) 

int FAR PASCAL LibMain(HINSTANCE hlnst, WORD wDataSeg, 

I 

G1obalUnlock(hCtlInfo); 

WORD cbHeap, LPSTR IpszCmdLine) 

return hCtllnfo; 

\ 

l 

GLOBALHANDLE hWC; 

/ 

lpCtlInfo->Type[wNumTypes].wType = 0; 

LPWNDCLASS lpwc; 

/* default size if dialog editor */ 

BOOL class found = FALSE; 

lpCtlInfo->Type[wNumTypes].wWidth = 48; 

char wrk[16]; 

lpCtlInfo->Type[wNumTypes].wHeight = 48; 
lpCtlInfo->Type[wNumTypes].dwStyle = 

Modulelnstance = hlnst; 

BIGLB DEFAULT STYLE; /* default style bits */ 

if (cbHeap > 0) 

LoadString(Modulelnstance, IDS CONTROL NAME, (LPSTR) 

UnlockData(O); 

41pCtlInfo->Type[wNumTypes].szDescr, CTLDESCR); 
lpCtlInfo->wCtlTypes++; 

hWC - GlobalA11oc(GHND, sizeof(WNDCLASS)); 

GlobalUnlock(hCtlInfo); 

if (hWC != NULL) 

return hCtllnfo; 

\ 

l 

lpwc = (LPWNDCLASS) Global Lock(hWC); 


if (lpwc != NULL) 

#ifdef BORLANDC 

{ 

fpragma argsused 

/* set up the control class */ 

#endif 

lpwc->Style = CS HREDRAW | CS VREDRAW | 

WORD WINAPI export BigLBFlags(DWORD dwFlags, 

CS GLOBALCLASS | CS DBLCLKS; 

LPSTR szString, WORD wMaxString) 

lpwc->lpfnWndProc = (WNDPROC) BigLBWndFn; 

{ 

lpwc->cbClsExtra = 0; 

WORD i; 

/* reserve extra bytes for memory management */ 


lpwc->cbWndExtra = EXTRA WND BYTES; 

/* assume the the buffer will never overflow */ 

lpwc->hlnstance = hlnst; 

♦szString * ‘\0'; 

lpwc->hIcon = NULL; 

if ((dwFlags & LBS STANDARD) == LBS STANDARD) 

lpwc->hCursor = NULL; 

LoadString(ModuleInstance, IDS STAND, 

lpwc->hbrBackground = NULL; 

&szString[lstrlen(szString)],25); 

lpwc->lpszMenuName = NULL; 

el se 

LoadString(hInst, IDS CONTROL NAME, (LPSTR)&wrk, 16); 

1 

lpwc->lpszClassName = (LPSTR) wrk; 

if ((dwFlags & LBS NOTIFY) == LBS NOTIFY) 

class found = (RegisterClass(lpwc) != NULL); 

LoadString(ModuleInstance, IDS NOTIFY, 

GlobalUnlock(hWC); 

&szString[lstrlen(szString)],25); 

) 

if ((dwFlags & LBS SORT) == LBS SORT) 

GlobalFree(hWC); /* free the space... */ 

LoadString(Modulelnstance, IDS SORT, 

) 

AszString[1strlen(szString)],25); 

return (class found); 

} 

) 

if ((dwFlags & LBS_NOREDRAW) == LBS_NOREDRAW) 

Loadstring(Modulelnstance, IDS_REDRAW, 

4szString[lstrlen(szString)],25); 

GLOBALHANDLE WINAPI export BigLBInfo(void) 

if ((dwFlags & LBS USETABSTOPS) == LBS USETABSTOPS) 

I 

LoadString(ModuleInstance, IDS LBTS, 

GLOBALHANDLE hCtllnfo = NULL; 

&szString[lstrlen(szString)],25); 

LPCTLINFO lpCtlInfo; 

if ((dwFlags & LBS NOINTEGRALHEIGHT) == LBS NOINTEGRALHEIGHT) 

WORD wNumTypes; 

LoadString(ModuleInstance, IDS INTEG, 

4szString[lstrlen(szString)],25); 

if ((hCtlInfo = GlobalAlloc(GMEM MOVEABLE|GMEM ZEROINIT, 

if ((dwFlags 4 LBS MULTICOLUMN) == LBS MULTICOLUMN) 

(DWORD) sizeof(CTLINFO))) == NULL) 

LoadString(ModuleInstance, IDS MULTIC, 

return NULL; 

AszString[lstrlen(szString)],25); 

lpCtlInfo = (LPCTLINFO) G1obalLock(hCtlInfo); 

if ((dwFlags 4 LBS WANTKEYBOARDINPUT) == LBS WANTKEYBOARDINPUT) 

lpCtlInfo->wVersion = 0x0100; 

LoadString(ModuleInstance, IDS KEYB, 

/* Initialize wCtlTypes to zero */ 

4szString[lstrlen(szString)],25); 

lpCtlInfo->wCtlTypes = 0; 

/* this style is Windows 3.0a and above */ 
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that are to be compared. If the items are strings, returning the 
result of IstrcmpO will work just fine. If the items are 
pointers to structures, it will be necessary to dereference the 
pointers supplied by the COMPAREITEM structure and possibly 
do more computations to determine the ordering. 

Finally, the parent window handles UM_DELETEITEM when¬ 
ever an item is deleted from an OVERDRAW listbox. Windows 
provides a pointer to a DELETEITEM structure that contains a 
pointer to the item to delete. If your heap management is 


more sophisticated than mine, go ahead and free global 
memory and compact the heap upon receiving this message. An 
LB_RESETCONTENT message sends a UM_DELETEITEM message to 
the parent window for each item in the listbox. I ignore this 
message. 

Dialog Editor Interface 

I have included the code necessary to make the extended 
listbox control accessible from dialog editors. In LibMainf), 


Listing 5 continued 


#1f (WINVER > 0x0300) 

if ((dwFlags&LBS_DISABLENOSCROLL) == LBS_DISABLEN0SCR0LL) 
Loadstring(ModuleInstance, IDS_LBSB, 

4szString[l strlen(szString)],25); 

#endif 

/* hack off the trailing • | " */ 
i = lstrlen(szString); 
if (i > 0) 
i -= 2; 

szString[i] * 0; 
return i; 


BOOL WINAPI _export BigLBStyle(HWND hWnd, GL0BALHANDLE 
hCtlStyle, LPFNSTRTOID lpfnSTRtoID, LPFNIDTOSTR lpfnIDtoSTR) 

{ 

LOCALHANDLE hCtlStyleDlg; 

NPCTLSTYLEDLG npCtlStyleDlg; 

BOOL bResult; 
char wrk[16]; 

if ((hCtlStyleDlg=LocalA11oc(LMEM_M0VEABLE|LMEM_ZER0INIT, 
sizeof(CTLSTYLEDLG))) == NULL) 

return FALSE; 

npCtlStyleDlg = (NPCTLSTYLEDLG)Local Lock(hCtlStyleDlg); 
npCtlStyleDlg->hCtlStyle ■ hCtlStyle; 
npCtlStyleDlg->lpfnStrToId = lpfnSTRtoID; 
npCtlStyleDlg->lpfnIdToStr = lpfnIDtoSTR; 

Local Uni ock(hCtl Styl eDlg); 

/* associate the CLTSTYLEDLG structure with this 
* window (the dialog editor) via a string */ 
SetProp(hWnd, MAKEINTRES0URCE(IDS_CTL_PR0P), hCtlStyleDlg); 

/* popup the sytle dialog box */ 

LoadString(ModuleInstance,BIGLB_STYLE_DLG,(LPSTR)&wrk,16); 
bResult = DialogBoxParam(ModuleInstance, (LPSTR)wrk, hWnd, 
(DLGPR0C) BigLBDlgFn, NULL); 

/* clean up property lists */ 

RemoveProp(hWnd, MAKEINTRES0URCE(IDS_CTL_PR0P)); 

Local Free(hCtlStyleDlg); 
return bResult; 


LPCTLSTYLE WINAPI CtlStyleLock(HWND hDlg) 


I 


LOCALHANDLE hCtlStyleDlg; 

NPCTLSTYLEDLG npCtlStyleDlg; 

LPCTLSTYLE lpCtlStyle; 

if ((hCtlStyleDlg=(LOCALHANDLE)GetProp(GetParent(hDlg), 
MAKEINTRES0URCE(IDS_CTL_PR0P))) == NULL) 
return NULL; 

npCtlStyleDlg = (NPCTLSTYLEDLG)Local Lock(hCtlStyleDlg); 
lpCtlStyle = (LPCTLSTYLE) 

Global Lock(npCtlStyleDlg->hCtlStyle); 

Local Uniock(hCtlStyleDl g); 
return lpCtlStyle; 


void WINAPI CtlStyleUnlock(HWND hDlg) 


LOCALHANDLE hCtlStyleDlg; 

NPCTLSTYLEDLG npCtlStyleDlg; 

if ((hCtlStyleDlg = GetProp(GetParent(hDlg), 

MAKEINTRESOURCE(IDS_CTL_PROP))) == NULL) 

return; 

npCtlStyleDlg = (NPCTLSTYLEDLG)Local Lock(hCtlStyleDlg); 
G1obalUniock(npCtlStyleDlg->hCtlStyle); 
LocalUnlock(hCtlStyleDlg); 


WORD WINAPI GetIDString(HWND hDlg.LPSTR szId.WORD wldHaxLen) 

f 

LOCALHANDLE hCtlStyleDlg; 

NPCTLSTYLEDLG npCtlStyleDlg; 

LPCTLSTYLE lpCtlStyle; 

WORD wldLen; 
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when calling RegisterClass(), I use a NULL background brush 
since no painting will be required on the window created with 
my BIGLB class. I also reserve the extra window bytes used 
by the memory management routines. 

WEP(), the infamous Windows Exit Procedure and library 
termination function (see Listings 6 and 8) has an ordinal value 
of 1 and the RESIDENTNAME parameter. In order for 
RESIDENTNAME to function properly, uppercase the name of 
the library module in the .def file LIBRARY statement and 


make it match the DLL's file name. Under Windows 3.0, the 
UEP() had to be in a FIXED, NONDISCARDABLE code segment 
to avoid an UAE if Windows discarded UEP()'s code segment 
under low memory conditions. This is apparently no longer 
the case under Windows 3.1, but for backward compatibility, I 
made UEP()' s code segment FIXED and NONDISCARDABLE. The 
bottom line in all the thoroughly confusing information about 
WEP() is that it must unregister the control class and return 1 
to indicate success. Windows 3.1 will unregister the class for 


Listing 5 continued 


/* Property is associated with Dialog Editor's window. 

return (BOOL) ((style & WS TABSTOP ) != 0); 

* Parent of the dialog box is the Dialog Editor. */ 

case ID GROUP : 

if ((hCtlStyleDlg = (LOCALHANDLE)GetProp(GetParent(hDlg), 

return (BOOL) ((style & WS GROUP ) != 0); 

MAKEINTRESOURCE ( IDS CTL PROP))) == NULL) 

case ID VIS : 

return 0; 

return (BOOL) ((style & WS VISIBLE ) != 0); 

npCtlStyleDlg = (NPCTLSTYLEDLG)Local Lock(hCtlStyleDlg); 

case ID DISA ; 

lpCtlStyle = (LPCTLSTYLE) 

return (BOOL) ((style & WS DISABLED ) != 0); 

G1obalLock(npCtlStyleDlg->hCtlStyle); 

case ID BORDER : 

wldLen » (*npCtlStyleDlg->lpfnIdToStr) 

return (BOOL) ((style & WS BORDER ) != 0); 

(lpCtlStyle->wld, szld, wldMaxLen); 

case ID HORZSB : 

G1obalUniock(npCtlStyleDlg->hCtlStyl e); 

return (BOOL) ((style & WS HSCROLL ) 1=0); 

Local Uniock(hCtlStyleDl g) ; 

case ID VERTSB : 

return wldLen; 

return (BOOL) ((style & WS VSCROLL ) != 0); 

) 

default : return (FALSE); 

) 

DWORD WINAPI SetIDValue(HWND hDlg, LPSTR szld) 

) 

I 

LOCALHANDLE hCtlStyleOlg; 

void SetIDStyleBits(int id.LPDWORD style) 

NPCTLSTYLEDLG npCtlStyleDlg; 

{ 

LPCTLSTYLE lpCtlStyle; 

switch (id) 

DWORD dwResult = 0; 

{ 

case ID NOTIFY : (‘style) |= LBS NOTIFY; 

if ( (hCtlStyleDlg= ( LOCALHANDLE)GetProp(GetParent(hDlg), 

break; 

MAKEINTRESOURCE(IDS CTL PROP))) == NULL ) 

case ID SORT : (‘style) |« LBS SORT; 

return NULL; 

break; 

npCtlStyleDlg • (NPCTLSTYLEDLG)Local Lock(hCtlStyleDlg); 

case ID MULTIC : (‘style) |= LBS MULTICOLUMN; 

dwResult * (*npCtlStyleDlg->lpfnStrToId)(szld); 

break; 

LocalUnlock(hCtlStyleDlg); 

case ID REDRAW : (‘style) | = LBS NOREDRAW; 

/* If LOWORD is zero, string NOT found. */ 

break; 

if (LOWORD(dwResult) == 0) 

case ID LBTS : (‘style) |= LBS USETABSTOPS; 

return dwResult; 

break; 

/* LOWORD is not zero, numeric ID is in the HIWORD. */ 

case ID INTEG: (‘style) &= ~LBS NOINTEGRALHEIGHT; 

lpCtlStyle = CtlStyleLock(hDlg); 

break; 

lpCtlStyle->wld = HIWORD(dwResult); 

case ID KEYB: (‘style) j- LBS WANTKEYBOARDINPUT; 

CtlStyleUnlock(hDlg); 

break; 

return dwResult; 

#if (WINVER > 0x0300) 

I 

case IDLBSB : (‘style) |= LBS_DISABLENOSCROLL; 
break; 

fendif 

BOOL IDtoStyleBits(int id,DWORD style) 

case ID ATTS : (‘style) |= WS TABSTOP; 

( 

break; 

switch (id) 

case ID GROUP : (‘style) |= WS GROUP; 

{ 

break; 

case ID NOTIFY : 

case ID VIS : (‘style) |« WS VISIBLE; 

return (BOOL) ((style & LBS NOTIFY) != 0); 

break; 

case ID SORT : 

case ID DISA : (‘style) |= WS DISABLED; 

return (BOOL) ((style & LBS SORT) 1=0); 

break; 

case ID MULTIC : 

case ID BORDER : (‘style) |= WS BORDER; 

return (BOOL)((style & LBS MULTICOLUMN) != 0); 

break; 

case ID REDRAW : 

case ID HORZSB : (‘style) |= WS HSCROLL; 

return (BOOL) ((style A LBS NOREDRAW) != 0); 

break; 

case ID LETS : 

case ID VERTSB : (‘style) |= WS VSCROLL; 

return (BOOL) ((style & LBS USETABSTOPS) != 0); 

break; 

case ID INTEG : 

default : (‘style) |- WS CHILD; 

return (BOOL) ((style&LBS NOINTEGRALHEIGHT) == 0); 

break; 

case ID KEYB: 

) 

return (BOOL)((style&LBS WANTKEYBOARDINPUT) != 0); 

#if (WINVER > 0x0300) 
case ID LBSB: 

) 

return (BOOL) ((style & LBS DISABLENOSCROLL) != 0); 

fifdef BORLANDC 

lendif 

fpragma argsused 

case ID_ATTS : 

fendif 
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you as part of its comprehensive clean-up procedure if you 
register the control class with the CSJGLOBALCLASS style. In 
my control testing iterations, I found that the system called 
UEP() whenever my code or windows destroys the last in¬ 
stance of the custom control. 

The extended listbox style dialog box lets the user define 
most of the LBS_ styles and several US_ styles that govern the 
appearance and resource creation style of the extended 


listbox control. The LBS_NOINTEGRALHEIGHT style is specially 
handled in the dialog procedure because it reflects a negative 
state. The dialog box asks whether or not the control should 
have an integral height — that is, whether the height should 
be rounded to the nearest item. If you don't want the height 
rounded, the LBS_NOINTEGRALHEIGHT style is set; otherwise, 
no extra style bits are required. 


Listing 5 continued 


BOOL CALLBACK _export BigLBDlgFn(HWND hDlg, 

UINT msg, WPARAM wParam, LPARAM IParam) 

1 

char szID[20]; 

DWORD dwResult; 

LPCTLSTYLE lpCtlStyle; 
int i; 

BOOL state; 

switch (msg) 

1 

case WMJNITDIALOG : 

GetIDString(hDlg,szID,20); 

SetDlgltemText(hDlg.ID_IDNAME.szID); 

/* lock the property resource */ 
lpCtlStyle « CtlStyleLock(hDlg); 
for (i’=ID_NOTIFY; i <= ID_H0RZSB; i++) 

( 

/* set the state of the checkboxes */ 
state = IDtoStyleBits(i, 

(1 pCtlStyle->dwStyle)); 
SendDlgItemMessage(hDlg, i, BM_SETCHECK, 
state, NULL); 

I 

CtlStyleUnlock(hDlg); 
return (FALSE); 
case WM_COMMAND : 

if (wParam == ID_IDNAME) 

if (HIWORD(lParam) == EN_CHANGE) 

( 

Enabl eWi ndow(GetDl gltem(hDlg,IDOK), 
SendMessage((HWND) LOWORD(lParam), 
WM_GETTEXTLENGTH, NULL, NULL) 

? TRUE : FALSE); 

break; 

) 

if (wParam == IDCANCEL) 

( 

EndDialog(hDlg,wParam); 
break; 


if (wParam == IDOK) 

( 

GetDlgltemText(hDlg,ID_IDNAME,szID,20); 
dwResult = SetlDValue(hDlg.szID); 

/* check validity of ID */ 
if (LOWORD(dwResult) — 0) 

{ 

MessageBeep(MBOK); 
break; 

} 

/* get the state of all the buttons, set the style bits */ 
dwResult = WS_CHILD; 
for (i=ID_NOTIFY; i <= ID_H0RZ$B; i++) 

{ 

state = (BOOL) 

SendDlgItemMessage(hDlg, i, 
BM_GETCHECK,NULL,NULL); 
if (state) 

SetIDStyleBits(i,&dwResult); 
else 

if (i == ID_INTEG) 


dwResult |= LBS_NOINTEGRALHEIGHT; 

} 

lpCtlStyle = CtlStyleLock(hDlg); 
lpCtlStyle->dwStyle = dwResult; 
CtlStyleUnlock(hDlg); 

EndDialog(hDlg.wParam); 
break; 

) 

default : return FALSE; 

) 

return (TRUE); 

) 


/* End of File */ 
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Listing 6 wep.c - Windows Exit Procedure for big 
listbox 


/* wep.c - Windows Exit Procedure for Big Listbox custom 
control */ 

linclude “bigib.h" 

lifdef _BORLANDC_ 

Ipragma hdrstop 
lendif 

/* WEP needs to be in a FIXED, NONDISCARDABLE code segment 
* for use with Windows 3.0 
*/ 

#ifdef _BORLANDC_ 

Ipragma argsused 
lendif 

int WINAPI _export WEP(int nExitType) 

{ 

char wrk[16]; 

LoadString(Modulelnstance, 

IDS_C0NTR0L_NAME, 

(LPSTR)&wrk,16); 

UnregisterClass(wrk.Modulelnstance); 
return 1; 

) 

/* End of File */ 


The dialog editor “Flags” function is responsible for turning 
style bits into symbolic constants. I use the DLL's resource 
STRINGTABLE to store the symbolic strings for the LBS_ styles. 

BigLBUndFnf) is the window function that the application 
program uses to communicate with the extended listbox con¬ 
trol. It creates a borderless window for itself, as well as a child 
window that will have all of the attributes specified in the 
application's CreateUindowf) call plus the LBSJWNERDRAU- 
FIXED style. I pass all the listbox specific messages directly to 
the subclassing function where they will be handled ap¬ 
propriately. 

Since applications that use my custom control are sending 
messages to the hidden parent window and not to the listbox 
itself, the parent window must handle a few messages 
needed to maintain functional transparency. Among these are 
UMJNABLE, UMJETFOCUS, UMJIZE, UMJET REDRAU, and, Of 
course, the OUNERDRAU messages discussed above. The parent 
window also echos UMJOMMAND messages, namely LBN_ 
notification messages, to the application that owns the control. 

There seems to be a “Catch-22" when changing the font in 
an ownerdrawn listbox. Creating an instance of the extended 
control with a call to CreateUindowf) generates an initial 
UM_MEASUREITEM message that is serviced by specifying the 
height, in pixels, of each entry in the ownerdrawn listbox. The 


Listing 7 biglb.rc - Resource definitions for big listbox 


/* biglb.rc - String table and dialog box for Big Listbox 

#el se 

*/ 

CONTROL "S&croll bar always", 10 LBSB, "BUTTON", 

BS AUTOCHECKBOX|WS CHILD|WS VISIBLE|WS TABST0P| 

#include "bigib.h" 

BIGLBSTYLEDLG DIALOG 25, 25, 192, 184 

WS_DISABLED,85, 135, 80, 11 
lendif 

STYLE WS BORDER | WS CAPTION | WS POPUP | WS DLGFRAME 

CONTROL "&Tab Stop", ID ATTS, "BUTTON", 

CAPTION "Big Listbox Style" 

BS AUTOCHECKBOX|WS CHILD|WS VISIBLE|WS TABST0P| 

BEGIN 

WS GROUP, 15, 30, 45, 12 

CONTROL "", ID IDNAME, "EDIT", 

CONTROL "&Group", ID GROUP, "BUTTON", 

ES LEFT|WS CHILD|WS VISIBLE|WS B0RDER|WS TABSTOP, 

BS AUTOCHECKBOXIWS CHILD|WS VISIBLE|WS TABSTOP, 

75, 5, 105, 12 

15, 49, 45, 12 

CONTROL "&Notify", ID NOTIFY, “BUTTON", 

CONTROL "&Visible", ID VIS, "BUTTON", 

BS AUTOCHECKBOX|WS CHILD|WS VISIBLE|WS TABST0P| 

BS AUTOCHECKBOX|WS CHILD|WS VISIBLE|WS TABSTOP, 

WS GROUP,85, 31, 80, 11 

15, 68, 45, 12 

CONTROL "&Sort", ID SORT, "BUTTON", 

CONTROL "&Disabled\ ID DISA, "BUTTON", 

BS AUTOCHECKBOX|WS CHILD|WS VISIBLE|WS TABSTOP, 

BS AUTOCHECKBOX|WS CHILD | WS VISIBLE|WS TABSTOP, 

85, 45, 80, 11 

15, 87, 45, 12 

CONTROL "Don't &redraw", ID REDRAW, "BUTTON", 

CONTROL "&Border\ ID BORDER, "BUTTON", 

BS AUT0CHECKB0X|WS CHILD|WS VISIBLE | WS TABSTOP, 

BS AUTOCHECKBOX|WS CHILD|WS VISIBLE | WS TABSTOP, 

85, 60, 80, 11 

15, 106, 45, 12 

CONTROL "Use Tab Sto&ps", ID LBTS, "BUTTON", 

CONTROL "V&ertical", ID VERTSB, "BUTTON", 

BS AUT0CHECKB0X|WS CHILD|WS VISIBLE|WS TABSTOP, 

BS AUTOCHECKBOX|WS CHILD|WS VISIBLE|WS TABSTOP| 

85, 75, 80, 11 

WS GROUP, 15, 147, 35, 12 

CONTROL "Integral &height\ ID INTEG, "BUTTON", 

CONTROL “Hori&zontal", ID HORZSB, "BUTTON", 

BS AUT0CHECKB0X|WS CHILD|WS VISIBLEjwS TABSTOP, 

BS AUTOCHECKBOX|WS CHILD|WS VISIBLE | WS TABSTOP, 

85, 90, 80, 11 

15, 162, 45, 12 

CONTROL “SMulti column", ID MULTIC, "BUTTON", 

CONTROL "&0kay“, IDOK, "BUTTON", 

BS AUT0CHECKB0X|WS CHILD|WS VISIBLE | WS TABSTOP, 

BS DEFPUSHBUTTON|WS CHILD|WS VISIBLE|WS GROUP | 

85, 105, 80, 11 

WS TABSTOP, 80, 157, 35, 20 

CONTROL "Pass &keyboard input", ID KEYB, "BUTTON", 

CONTROL "&Cancel " , IDCANCEL, "BUTTON", 

BS AUTOCHECKBOX|WS CHILD|WS VISIBLE|WS TABSTOP, 

BS PUSHBUTTON|WS CHILD|WS VISIBLE|WS TABSTOP, 

85, 120, 80, 11 

135, 157, 35, 20 

CONTROL “Scroll Bar", -1, "button". 

#if (WINVER > 0x0300) 

BS GR0UPB0X|WS CHILD|WS VISIBLE, 

CONTROL "S&croll bar always", ID LBSB, "BUTTON", 

10, 137, 55, 40 

BS AUT0CHECKB0X|WS CHILD|WS VISIBLE|WS TABSTOP, 

CONTROL "Attributes", -1, "button". 

85, 135, 80, 11 

BS GR0UPB0X|WS CHILD|WS VISIBLE, 

10, 22, 55, 103 
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default item height is the height of the system font. But since 
the control is still in the process of being created, you do not 
yet have a valid window handle where a NMJETFONT mes¬ 
sage can be sent to change the item height. That's the catch. 
You have to know, and subsequently provide, the height of 
the font you want to use before you can create the listbox. 
You can change the font after the extended control is created, 
but this causes a redraw error, because the items are still 
aligned with their original default heights. 

I have provided a way to set the font at control creation 
time. You may pass a pointer to a valid font handle as a 
control creation parameter. The UMJREATE service will take 
care of measuring the height of the specified font and change 
the listbox's font There doesn’t seem to be a documented 
way to get an ownerdrawn listbox to remeasure itself on the 
fly. Thus, I ignore any additional UMJETFONT messages. If you 
specify NULL as the creation parameter, the control uses the 
default system font. I use window properties to forward the 
font handle to the UM_MEASUREITEM message without using 
any static data in the control’s local heap, which is being 
shared by other instances of the control. 

The UMJNABLE, UMJETFOCUS, UMJIZE, and NHJET REDR AN 
messages are passed along to the subclass listbox. Basically, if 
the hidden parent window is enabled or disabled, I want to 
enable or disable the listbox as well. When changing the 
enabled state of the listbox, I request a redraw so that Win¬ 
dows will redraw the control with the appropriate text color. 
Similarly, the input focus should not be given to the hidden 
window, but rather to the listbox. When the custom control is 
sized, I size both the listbox and the hidden parent. Finally, 
any NMJAINT messages received by the parent cause it to 
request a redraw of the listbox. The ONNERDRAN messages, once 
handled, not require default processing, other messages call for 
default processing, depending on whether or not both the hidden 
parent window and the listbox need to receive the message. 

The NMJESTROY message is handled more as a matter of 
style and consistency. Windows 3.1 is very good about clean¬ 
ing up child windows and global memory. I go free the 
control's global heap and destroy the listbox anyway, because 
earlier versions of Windows are not quite so hygienic. 

LB8192 

LB8192 is a program that I wrote to demonstrate and test 
the BIGLB class control; the code appears on the code disk. 
LB8192 creates two child windows, a custom listbox, and a 
pushbutton that enables and disables the listbox to 
demonstrate the text graying and activation states. Double¬ 
clicks on the extended listbox are answered with a double 
MessageBeepO. Figure 1 shows LB8192 in action. You can use 
LB8192 to quickly fill the listbox with entries. 

Implementation Notes 

One listbox style, LBSJODISABLESCROLL, is not available 
under Windows 3.0. I used compiler directives to bypass code 
generation for that option when NINVER is set to 0x0300. This 
style allows the programmer to specify that the scrollbar on 
the listbox will always be visible. Normally, the scrollbar ap¬ 
pears only when there are too many items to fit in the listbox 
client area. In the resource file (Listing 7), I OR in the NSJIS- 


Listing 7 

continued 

CONTROL "Listbox Styles", -1, "button". 

BS GR0UPBOX|WS CHILD|WS VISIBLE, 

75, 22, 105, 

128 

CONTROL "Control &ID", -1, "STATIC", 

SS CENTER|WS CHILD|WS VISIBLE|WS GROUP, 

10, 7, 55, 10 

END 


STRINGTABLE 


BEGIN 


BIGLB STYLE DLG, "BIGLBSTYLEDLG" 

IDS CTL PROP, 

"BIGLBCTLPR0P" 

IDS CONTROL NAME,"BIGLB" 

IDS NOTIFY, 

“LBS NOTIFY | " 

IDS SORT, 

"LBS SORT | " 

IDS REDRAW, 

"LBS N0REDRAW | “ 

IDS LBTS, 

"LBS USETABST0PS | " 

IDS INTEG 

"LBS NOINTEGRALHEIGHT | " 

IDS MULTIC, 

"LBS MULTICOLUMN | “ 

IDS KEYS, 

"LBS WANTKEYBOARDINPUT | ■ 

IDS LBSB, 

“LBS DISABLEN0SCR0LL | " 

IDS STAND, 

"LBS STANDARD | " 

END 



ABLED style so that this particular style option will be grayed 
out if the control is compiled for Windows 3.0. 

In part 2 of his article, “Fading in Custom Controls for Win¬ 
dows 3” (Windows/DOS Developer’s Journal, March 1992), Victor 
Volkman listed “do’s and don'ts” for custom controls, including 
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Listing 8 

listbox 

biglb.def — Module definition file for big 

• 

; Listing # 8 - 

BIGLB.DEF 

LIBRARY BIGLB 


DESCRIPTION 'BIGLB (c) Dimensional Software' 

EXETYPE WINDOWS 


STUB 'WINSTUB.EXE' 

CODE PRELOAD MOVEABLE DISCARDABLE SHARED 

DATA PRELOAD MOVEABLE DISCARDABLE SINGLE 

HEAPSIZE 1024 


SEGMENTS 


WEP TEXT FIXED NONDISCARDABLE SHARED 

EXPORTS 


WEP 

81 RESIDENTNAME 

BigLBInfo 

82 

BigLBStyle 

83 

BigLBFlags 

84 

BigLBWndFn 

85 

BigLBDlgFn 

86 

BigLB_SubProc @7 


testing at different video resolutions and in different sizes. I'd 
like to add my own “do's”: "Do test your code with older ver¬ 
sions of Windows!" and “Do test your code under low 
memory conditions." I discovered a couple of Windows 3.0 
OWNERDRAU redraw problems that Windows 3.1 has solved. 
One redraw error occurred when the control was uncovered — 
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UM_DRAUITEM messages were not sent for the uncovered 
items. I fixed this by invalidating the control's client area 
whenever the hidden parent window received a m_PAINT 
message. This problem apparently had to do with the order in 
which the paint messages were queued. 

Another redraw error occurred when an empty control was 
created and given the input focus. The focus rectangle, which 
should appear to show that the control has the focus, gets 
erased under Windows 3.0. Apparently, the initial state of the 
focus flag bits is wrong. I worked around this problem by ad¬ 
ding an extra condition to the UM_DRAUITEM message han¬ 
dling: the focus rectangle is only drawn when itemID is 
greater than or equal to zero, indicating a valid listbox item. 
This condition makes the control work consistently with both 
older and newer versions of Windows, but it is not the correct 
way to show an empty listbox with the input focus. Under 
Windows 3.1, and without this extra condition, the custom 
listbox displays correctly. 

Conclusion 

I have shown how to implement a skeletal OUNERDRAW 
listbox capable of displaying over 8,000 items. I use plain 
strings to display in the listbox, but the pointers associated 
with each listbox entry could instead point to a data structure 
that contained a string, and an icon or a bitmap. Mixing both 
text and a bitmap would make a visually interesting control. 

I should note, however, that though this control vastly in¬ 
creases the number of possible display items, there are only 
rare circumstances where the user should be presented with 
8,000 choices! One example where such a display might be 
reasonable could be a list of files on a hard disk, or perhaps a 
complete listing of help topics. (The message from the 
Microsoft Windows designers is not “No, you can't do that,” 
but rather, “There is probably a better way to do that." Files 
are usually divided up into directories, and help topics are 
usually grouped under some heading.) This extended control is 
probably more useful for browsing rather than for maintaining 
a list with multiple inserts and deletes. 
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Custom Control 
Dialog Editor Interfaces 


Ron Burk 

Once you've built a custom control, adding a dialog editor interface 
makes it easier to use. Specifically, the dialog editor interface lets you use a 
tool like Borland's Resource Workshop or Microsoft's Dialog Editor to interac¬ 
tively position, size, and set attributes for instances of your custom control 
within dialog boxes. This is infinitely preferable to typing individual resource 
compiler command lines for each control, specifying coordinates and sizes 
numerically by hand. 

Adding a dialog editor interface should be straightforward for most cus¬ 
tom controls, but there are a couple of problems to solve if you want to do 
a good job. First, the two most popular dialog editors (Borland's and 
Microsoft’s) use slightly different interfaces to communicate with custom 
controls. Second, if you will be shipping your application to multiple users, 
you might prefer to have the custom control code reside within your ap¬ 
plication rather than in one or more distinct DLLs. This article shows you 
how to design your custom control so that it works with both Microsoft’s 
and Borland's dialog editors, and shows how to arrange your code so you 
can easily link it directly into your application or place it in a standalone 
DLL. The article also looks at the extra functionality you can tap if you are 
willing to forgo Microsoft compatibility. 

Microsoft’s Dialog Editor Interface 

To an application, a custom control is just a window class that is added 
to the standard window classes such as “Edit,’' “ListBox," and so on. Your 
application can create an instance of a custom control by 
specifying the custom control's class name when calling 
CreateWindow(). Of course, the custom control will have had 
to call RegisterClass() to register its window class name 
with Windows before your application calls CreateUindowf). 
If your custom control resides in a standalone DLL, it could 
simply call RegisterClass() in the LibMain() function for 
that DLL. Otherwise, the control will probably supply an ex¬ 
plicit initialization function that the application must call 
before it can create any instances of the custom control. 
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Windows programmers rarely call CreateWindowf) directly 
to create instances of such standard controls as “Edit” and 
“ListBox.” Instead, they use dialog editors to design dialog 
boxes that contain various controls. The dialog editor creates 
(either directly or via the Resource Compiler) a dialog resource 
that contains all the information about which controls go 
where in the dialog box. A function like DialogBox() then 
extracts that information from the dialog resource and takes 
care of the tedious task of calling CreateUindow() for each 
control, passing it the correct size, placement, window class 
name, and so on, that you defined interactively with the 
dialog editor. 

All of this works because the dialog editor “knows about" 
all of the standard controls built into Windows. To allow you 
to extend the standard set of controls, Microsoft's Dialog Editor 
uses a simple interface — consisting of three functions that 
you supply —to obtain information about your custom control. 
Because the Microsoft interface uses ordinal function numbers, 
you can name these functions whatever you want. The first 
function, generically referred to as the “Info” function, tells the 
dialog editor the name of your custom control. The dialog 
editor calls your second function, the “Style” function, to dis¬ 
play the dialog box that will allow your user to set attributes 
(such as style bits) for an instance of your custom control. 
Finally, the dialog editor calls the “Flags" function to have you 
translate the custom style bits you have defined for your con¬ 
trol into a string it can insert into the . rc file (for example, 
you might translate 0x0003 into ~CC_HORIZ_BAR | 
CC_DATE_FIELD"). This assumes your .rc file will include a 


header file that defines these symbols for your custom style 
bits. 

The interface that I have described was available from 
Microsoft at least as far back as Windows 2.x. In this interface, 
the data structures passed via the "Info," “Style, and “Flags" 
functions include fields that are defined but not used. The 
data structures allow you to define multiple “types” of your 
custom control, each with its own set of default style bits and 
its own name. This capability would be handy where there 
were multiple commonly used settings of the style bits. For 
example, even though Windows contains only one edit con¬ 
trol, programmers most often use two common types: single- 
line and multiline edit controls. Rather than make you explicit¬ 
ly set a style bit to turn a single-line control into a multiline 
control (or vice versa), dialog editors offer both types directly 
on a menu or in a toolbox. Selecting one type or the other 
really amounts just to selecting different default style bits. 

Unfortunately, even though Microsoft's interface specifies 
data structures that let you define more than one variation of 
your custom control, Microsoft's Dialog Editor ignores all but 
the first control type! Microsoft still has not removed this 
limitation —even in the latest Windows 3.1 SDK. 

Another drawback of the Microsoft interface is that you 
cannot put more than one custom control in a single DLL. The 
Microsoft interface uses hard-wired ordinal function numbers 
rather than symbolic function names to access your DLL (for 
example, to call your InfoO function, it calls ordinal function 2). 
Using hard-wired numbers not only limits extensibility, but 
also makes the interface less robust. To return to the “Info" 
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function example: while most DLLs do not export a symbol 
called "Info,” most do export ordinal function 2, so if you give 
Microsoft’s Dialog Editor the wrong DLL to load, it will probably 
crash the program or Windows itself. 

Despite regular requests from programmers for features 
such as the ability to place multiple controls in a DLL, the 
Microsoft Dialog Editor custom control interface has remained 
essentially stagnant from Windows 2.x through Windows 3.1. 

Borland’s Dialog Editor Interface 

While Microsoft’s Dialog Editor interface was standing still, 
Borland’s Resource Workshop arrived and demonstrated how 
straightforward it was to extend and improve the Microsoft 
interface and still maintain backward compatibility. When you 
tell Resource Workshop to load a cus¬ 
tom control DLL, it starts by doing a 
GetProcAddress() on a function called 
“Classlnfo.” If this function is present, 

Resource Workshop calls it to obtain a 
list that describes each of the custom 
controls in the DLL. Each entry in the list 
contains pointers to the three interface 
functions ("Info”, “Style”, and “Flags") for 
that control. 

Since Resource Workshop assumes 
you have a symbolic export called 
"Classlnfo”, how can it work with a DLL 
that was built for Microsoft's Dialog 
Editor? Simple. If Resource Workshop 
does not find Class Info (), it assumes 
you are using the Microsoft interface. 

However, Resource Workshop tries to 
avoid just blindly calling ordinal function 
2, to avoid crashing if you specify the 
wrong DLL. It first checks to see if you 
have symbolically exported a function 
called “xxxlnfo,” where "xxx” is the 
name of your DLL. If so, it assumes that 
all is well and proceeds to load the cus¬ 
tom control. If not, there really is no 
way to know if this is a valid custom 
control DLL, so Resource Workshop dis¬ 
plays a message box telling you this 
may not be a valid custom control and 
asking whether you want to proceed. 

This points to one very simple tech¬ 
nique for making your custom control 
work smoothly with both Microsoft and 
Borland tools. The only change you 
need to make to a Microsoft custom 
control is to also export the interface 
functions symbolically, based on the 
name of the DLL. Suppose you have a 
Microsoft-style custom control in 
foo.dll whose .def file exports look 
like this: 


EXPORTS 

WEP @1 RESIDENTNAME 
@2 
@3 
@4 

You would simply change the export section to read: 
EXPORTS 

WEP @1 RESIDENTNAME 
Foolnfo @2 
FooStyle @3 
FooFlags @4 
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• Fully supports ANSI SQL 86 level 2 
standards, outer-join, referential 
integrity constraints, multi-user 
concurrency controls (four isola¬ 
tion levels), crash recovery, transac¬ 
tion processing, scroll cursors and 
security features. 

• Supports multiple instances, BLOB 
and read-only schemas (for CD- 
ROMs). 

• Offers custom controls for Visual 
Basic. 

• supports embedded SQL for Visual 
Basic and other languages. 

• Embedded SQL preprocessor for 
C. 

• VBQUERY, an interactive query 
tool, written in Visual Basic and 
dQUERY are included. 

Call for a free demo disk. 
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Listing 1 ccdlg.h 


/* CC_NAME - The class name your custom control is registered under */ 
Idefine CC_NAME DndEdit 

/* CC_CLASS_NAME - Same as CC_NAME value, but in quotes */ 

Idefine CC_CLASS_NAME "DndEdit" 

/* CC_DEFAULT_STYLE - Default style bits for your custom control */ 
#define CC_DEFAULT_STYLE WS_CHILD|WS_VISIBLE\ 

| WS_BORDER|ES_MULTILINE|ES LEFT\ 
j WS_TABSTOP|WS_VSCROLL|WS_HSCROLL\ 

| ES_AUTOVSCROLL|ES_AUTOHSCROLL 

typedef struct CC_FLAG 

{ 

long Flag; 

char ‘Symbol; 

} CC_FLAG; 

#if defined(TACKY_TRICK) 

/* CcFlags - Names and values of all control style bits */ 
static CC_FLAG CcFlags[] = 


f 


( ES CENTER, 

"ES CENTER" 

}. 

( ES RIGHT, 

"ES RIGHT" 

}, 

{ ES MULTILINE, 

"ES MULTILINE" 

}. 

{ ES UPPERCASE, 

"ES UPPERCASE" 

}, 

{ ES LOWERCASE, 

"ES LOWERCASE" 

), 

{ ES PASSWORD, 

"ES PASSWORD" 

}, 

{ ES AUTOVSCROLL, 

"ES AUTOVSCROLL" 

}. 

{ ES AUTOHSCROLL, 

"ES AUTOHSCROLL" 

}, 

{ ES NOHIDESEL, 

"ES NOHIDESEL" 

), 

( ES OEMCONVERT, 
lif (WINVER >= 0x0301) 

"ES_0EMC0NVERT" 

}, 

{ ES READONLY, 

"ES READONLY" 

), 

{ ES_WANTRETURN, 
lendif 

"ES_WANTRETURN“ 

) 


}; 


#endi f 


/* CC_TITLE - Arbitrary text, not used for much by any tool I know of */ 
Idefine CC_TITLE “DndEdit - Drag-and-Drop Edit control. " \ 

11 Copyright 1992 Windows/DOS Developer's Journal" 

/* CC_DEFAULT_WIDTH - Default width in dialog units or (if high 

* bit set) in pixels. */ 

Idefine CC_DEFAULT_WIDTH 50 

/* CC_DEFAULT_HEIGHT - Default width in dialog units or (if high 

* bit set) in pixels. */ 

Idefine CC_DEFAULT_HEIGHT 50 

/* CC_VERSION - upper byte is major version, lower is minor */ 
Idefine CC VERSION 0x0100 


/* You do not have to redefine these unless you want different names for 
* these functions 
*/ 


/* best not to think about ANSI token pasting rules ... *1 
Idefine CONCAT (a.b) CONCAT_(a,b) 

Idefine CONCAT (a,b) allb 


Idefine CC_REGISTER_FUNC 
Idefine CC_UNREGISTER_FUNC 
Idefine CC_DIA10G_FUNC 
Idefine CC_1NF0_FUNC 
Idefine CC_FLAGS_FUNC 
Idefine CC_STYLE_FUNC 

Idefine CC DIALOG NAME 


CONCAT_(CC_NAME, Register) 
CONCAT_(CC_NAME, Unregister) 
CONCAT_(CC_NAME, Dialog) 
CONCAT_(CC_NAME, Info) 
CONCAT_(CC_NAME, Flags) 
CONCAT_(CC_NAME, Style) 

CC_CLASS_NAME "_Dialog" 
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Note that Resource Workshop could still 
use your custom control without this 
change, but it would emit a warning 
message when loading it, since it is not 
particularly safe to assume that a DLL 
contains a custom control just because 
it exports ordinal functions 1 through 4. 

The ability to store more than one 
custom control in a single DLL is only 
one of the extensions that Resource 
Workshop offers over the Microsoft 
Dialog Editor custom control interface. 
You can also specify a 22x22 bitmap 
that Resource Workshop will use to 


paint the toolbox button corresponding 
to your custom control. You can supply 
another bitmap that Resource 
Workshop will use to draw the cursor 
when the user has selected the button 
corresponding to your custom controls. 
These extra touches help integrate your 
control with the rest of the dialog 
editor's user interface. 

The Need for Control Data 

Suppose you want to create a single 
custom control that provides a variety 
of input data validation algorithms in 


New Version 4.5 


Commenting Disassembler! 


Sources 


□ See how programs work 

□ Easily modify programs 

"Sourcer is the best disassembler 
we’ve ever seen." PC Magazine 


SOURCER ™ creates commented source 
code and listings from executable files or 
memory, suitable for reassembly. Sourcer 
helps clarify the inner workings of programs, 
with detailed in-line comments on interrupts, 
subfunctions, I/O ports functions, and much 
more. It offers complete support for all 
8088/87 to 80486 instructions and V20/V30. 
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Listing 1 continued 


#define CC_BITMAP_NAME CC_CLASS_NAME "Bitmap" 

#define CC_CURS0R_NAME CC_CLASS_NAME "_Cursor" 

/* None of the following should change */ 

typedef struct CCINITDIAL0G 
{ 

BOOL Extended; /* TRUE if extended interface */ 

HGL0BAL StyleData; 

LPFNSTRT0I0 StrToId; 

LPFNIDT0STR IdToStr; 

} CC_INIT_DIAL0G; 

/* End of File */ 


Listing 2 

ccdlg.c 

/* 


* ccdlg.c - 

Prototype dialog editor interface for a custom control. 

★ 

This code is designed to supply a complete interface to 

* 

both Microsoft's Dialog Editor and Borland's Resource 

★ 

Workshop. 

*/ 


#ifdef B0RLANDC 

lundef STRICT /* work around Borland header file bugs */ 
lundef WINVER 

lendif 


linclude <windows.h> 
linclude <custcntl.h> 
linclude <string.h> 
linclude <memory.h> 

Idefine TACKY TRICK 

linclude "ccdlg 

.h" 

HINSTANCE Modulelnstance; 

/* CTLTYPE_EX - 

extended version for Resource Workshop */ 

typedef struct 

f 

CTLTYPE 

CTLTYPEJX 

CtlType; 

HBITMAP 

ToolboxBitmap; 

HCURS0R 

DndCursor; 

) 

CTLTYPEJX; 

/* CTLSTYLE EX 

- extended version for Resource Workshop */ 
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Listing 2 continued 


typedef struct CTLSTYLE_EX 

{ 

CTLSTYLE CtlStyle; 

BYTE CtlDataSize; 

BYTE CtlData[255]; 

); 

int FAR PASCAL _WEP(int ExitCode) 

{ 

extern int CC_UNREGISTER_FUNC(void); 

switch(ExitCode) 

{ 

case WEP_SYSTEM_EXIT : 

case WEP_FREE_DLL : 

CC_UNREGISTER_FUNC(); 
return 1; 

} 

return 1; 

) 


lifdef _BORLANDC_ 

Ipragma argsused 
lendif 

int CALLBACK LibMain(HINSTANCE Module, WORD DataSegment, 

WORD HeapSize, LPSTR CommandLine) 

{ 

extern int CC_REGISTER_FUNC(H1NSTANCE); 

if(HeapSize != 0) 

UnlockData(O); 

Modulelnstance = Module; 
if(CC_REGISTER_FUNC(Module)) 
return 1; 

else 

{ 

MessageBox(NULL, "Could not register custom control 11 
CC_CLASS_NAME, MB_0K); 
return 0; 

} 

} 

CTLTYPE CtlType 

f 

0, CC_DEFAULT_WIDTH, CC_DEFAULT_HEIGHT, 

CC_DEFAULT_STYLE, 

{ CC_CLASS_NAME } 

); 

static 

HGLOBAL 01dStyleInfo(int ExtraBytes) 

{ 

HGLOBAL ReturnHandle; 

CTLINFO FAR ‘Info; 
size_t InfoSize; 

InfoSize = sizeof(CTLINFO) - (CTLTYPES-1)*sizeof(CTLTYPE); 

InfoSize += ExtraBytes; 

ReturnHandle » GlobalAlloc(GHND, InfoSize); 

if(ReturnHandle) 

{ 

Info * (CTLINFO FAR *)GlobalLock(ReturnHandle); 
if(!Info) 

{ 

GlobalFree(ReturnHandle); 
return FALSE; 

} 

Info->wVersion » CC_VERSION; 

Info->wCtlTypes = 1; /* only one control sub-type */ 


the form of pattern matching. For ex¬ 
ample, your control might recognize 
“(ddd) ddd-dddd’ (where “d” means 
allow any decimal numeral) as a pat¬ 
tern to validate phone numbers, or “ada 
a da” (where “a" means match any al¬ 
phabetic) to validate Canadian zip 
codes. The problem is, how can the 
user use a dialog editor to enter the 
desired pattern for an instance of your 
custom control? 

The Microsoft dialog editor interface 
provides two main attributes you can 
set for your custom control: style bits 
(up to 16) and window text (a null-ter¬ 
minated string). In this example, you 
would have to let the user specify the 
pattern as the window text for the con¬ 
trol, since there is no way to encode an 
arbitrary pattern into 16 style bits. 

Unlike style bits, window text is not 
really an attribute stored inside the 
Windows data structure for each win¬ 
dow. Window text is just a string stored 
in the dialog template by the dialog 
editor. When you call DialogBox() (or a 
similar function), it will pass the stored 
text to the child control in the call to 
CreateWindowO, as the windows 
“name.” 

Using window text to specify edit 
control attributes is not very intuitive 
for the programmer who uses your 
control, at least not for controls that 
contain text. It would be natural to ex¬ 
pect that the window text sets the ini¬ 
tial value of the contents of the control, 
which could also be retrieved with 
UM_GETTEXT messages or set with 
WM_SETTEXT messages. Using the initial 
value of window text (passed to the 
control in the UM_CREA TE message) for 
window attributes is a little less intui¬ 
tive and removes the ability to set the 
default text contents of the control at 
compile time. 

Using window text to store control 
attributes gets more and more strained 
as your control attributes get more 
elaborate, what if you want the user to 
be able to specify both a pattern and a 
maximum number of mistakes (for 
password validation perhaps)? You 
would have to cook up some syntax 
like “[pattern][max_tries].” With some 
controls, you might really want to store 
a data structure for internal use. Be¬ 
cause the window text must be null- 
terminated, you would first have to 
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encode your data structure bytes with 
some scheme that removed nulls and 
then decode the data structure at run¬ 
time. 

It's worth noting that the user does 
not actually have to enter data in en¬ 
coded form in these situations. Since 
your “style” function manages the dis¬ 
play of the dialog box that lets the user 
set window attributes, it can allow the 


user to enter complex data in a suitable 
format and then return that data en¬ 
coded in a string as the window text, to 
the dialog editor. However, the resulting 
. rc file will contain the encoded ver¬ 
sion, which could make altering the 
data difficult or impossible. 

This awkward situation results from 
the Microsoft custom control interface’s 
requirement that you use window text 


Listing 2 continued 


_fstrcpy(&Info->szClass[0], CC_CLASS_NAME); 
_fstrcpy(&Info->szTitle[0], CC_TITLE); 
_fmemcpy(&Info->Type[0], &CtlType, sizeof(CtlType)); 
GlobalUnlock(ReturnHandle); 

} 

return ReturnHandle; 

} 


HGLOBAL WINAPI _export CC_INFO_FUNC(void) 

{ 

return OldStylelnfo(O); 

) 


UINT FAR PASCAL _export CC_FLAGS_FUNC(DWORD Flags, 

LPSTR Buffer, UINT MaxString) 

{ 

int i; 

for(i = 0; i < sizeof(CcFlags)/sizeof(CC_FLAG); ++i) 
if(Flags & CcFlags[i] .Flag) 

if(_fstrlen(Buffer) + strlen(CcFlags[i].Symbol) + 3 >= MaxString) 
return 0; /* failed -- string too long */ 

else 

( 

if(‘Buffer) 

_fstrcat(Buffer, "|"); 

_fstrcat(Buffer, CcFlags[i] .Symbol); 

} 

return _fstrlen(Buffer); 

) 

BOOL FAR PASCAL _export CC_STYLE_FUNC(HWND Parent, GLOBALHANDLE StyleData, 
LPFNSTRTOID StrToId, LPFNIDTOSTR IdToStr) 

{ 

extern BOOL FAR PASCAL _export 

CC_DIALOG_FUNC(HWND Dialog, UINT Message, 

WPARAM WordParm, LPARAM LongParm); 

CC INIT DIALOG Initlnfo; 


Initlnfo.Extended = FALSE; 

Initlnfo.StyleData = StyleData; 

Initlnfo.StrToId = StrToId; 

Initlnfo.IdToStr = IdToStr; 

return DialogBoxParam(ModuleInstance, CC_DIALOG_NAME, 

Parent, CC_DIALOG_FUNC, (LPARAM)((CC INIT_DIA LOG FAR *)&In i tInfo)); 

) 


/*********** Th e Resource Workshop extended interface ********/ 
/* Avoid requiring inclusion of Borland's custcntl.h */ 

#ifndef BORLANDC 
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to store attributes of the custom con¬ 
trol other than the text displayed in the 
control. 


Remember that a dialog editor just 
produces a dialog resource containing 
information about all the controls in the 


The Hidden Bytes 

Since using window text to store 
control attributes isn't always practical, 
it would be nice if you could have a 
private data area apart from just style 
bits. In fact, you can have such a 
private data area, but you have to do 
some digging to find documentation on 
how to do it. 


dialog box. The real action happens at 
runtime when you call a function such 
as DialogBox(), which then uses the 
data in the dialog resource to call 
CreateUindow() for each control. 
CreateWindow() lets you pass an ar¬ 
bitrary data structure to the newly 
created window (via the IpCreate- 
Params field of the CREATESTRUCT 
passed to the UM_CREATE message). 


Listing 2 

continued 

typedef HGL0BAL (CALLBACK *LPFNL0ADRES)(LPCSTR, LPCSTR); 

typedef BOOL 

(CALLBACK ‘LPFNEDITRES)(LPCSTR, LPCSTR); 

typedef HGL0BAL (CALLBACK *LPFNINF0)(void); 

typedef BOOL (CALLBACK *LPFNSTYLE)(HWND, HGL0BAL, LPFNSTRTOID, LPFNIDT0STR) 
typedef UINT (CALLBACK ‘LPFNFLAGS)(DWORD, LPSTR, UINT); 

typedef struct 
( 

LPFNINF0 

RWCTLCLASS 

fnRWInfo; 

LPFNSTYLE 

fnRWStyle; 

LPFNFLAGS 

fnFlags; 

char 

szClass[CTLCLASS]; 

) 

RWCTLCLASS; 

typedef struct CTLCLASSLIST 
/ 

short 

nClasses; 

RWCTLCLASS 

Classes[l]; 

} CTLCLASSLIST: 

typedef struct 
/ 

RWCTLTYPE 

l 

UINT 

wType; 

UINT 

wWidth; 

UINT 

wHeight; 

DWORD 

dwStyle; 

char 

szDescrfCTLDESCR]; 

HBITMAP 

hToolBit; 

HCURSOR 

} 

hDropCurs; 

RWCTLTYPE; 

typedef struct 
/ 

RWCTLINFO 

i 

UINT 

wVersion; 

} 

RWCTLINFO; 

#endif 


HGLOBAL WINAPI export Rwlnfo(void) 

/ 

1 

HGLOBAL Handle: 

Handle = 01dStyleInfo(sizeof(RWCTLTYPE) - sizeof(CTLTYPE) ) ; 

if(Handle) 

/ 


\ 

HBITMAP 

FAR ‘ToolboxBitmap; 

HCURSOR 

FAR ‘DndCursor; 

CTLINFO 

FAR ‘Info; 

int 

InfoSize; 

Info 

= (CTLINFO FAR *)G1obalLock(Handle); 

if(Info) 

I 

InfoSize = sizeof(CTLINFO) - (CTLTYPES-l)*sizeof(CTLTYPE); 

ToolboxBitmap = (HBITMAP FAR *)((char FAR *)Info + InfoSize); 
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Wouldn't it be handy if DialogBoxf) 
could use this method to pass a pointer 
to some private data that your control 
created? The good news is that it doesl 
The bad news is that even though 
Microsoft put this mechanism into Win¬ 
dows itself, the Microsoft tools (Dialog 
Editor and Resource Compiler) do not 
support itl 

In fact, you might look long and hard 
before you found any documentation 
on this “secret" control data area. Both 
Borland and Microsoft omit coverage of 


the control data area from their online 
help files and their printed manuals. 
The only available information on the 
subject is in the additional text files of 
documentation that Borland supplies, in 
a file called custcntl.rw, which 
describes the Borland Resource 
Workshop interface for custom controls. 
According to this file, your “Style” func¬ 
tion can return up to 128 bytes of 
private control data along with the nor¬ 
mal window text, style bits, and so on. 
Borland’s Resource Workshop stores 
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Listing 2 continued 


DndCursor = (HCURS0R FAR *)((char FAR *)ToolboxBitmap + 

sizeof(HBITMAP)); 

‘ToolboxBitmap = LoadBitmap(ModuleInstance, CC_BITMAP_NAME); 
‘DndCursor = LoadCursor(ModuleInstance, CC_CURS0R_NAME); 

} 

} 

return Handle; 

} 

BOOL FAR PASCAL _export RwStyle(HWND Parent, GL0BALHANDLE StyleData, 
LPFNSTRT0ID StrToId, LPFNIDT0STR IdToStr) 

{ 

extern BOOL FAR PASCAL _export 

CC_DIAL0G_FUNC(HWN0 Dialog, UINT Message, 

WPARAM WordParm, LPARAM LongParm); 

CC_INIT_DIAL0G Initlnfo; 

Initlnfo.Extended = TRUE; 

Initlnfo.StyleData * StyleData; 

Initlnfo.StrToId = StrToId; 

Initlnfo.IdToStr = IdToStr; 

return DialogBoxParam(ModuleInstance, CC_DIAL0G_NAME, 

Parent, CC_DIAL0G_FUNC, (LPARAM)(CC_INIT_DIAL0G FAR *)&InitInfo); 

} 


lifdef _B0RLANDC_ 

Ipragma argsused 
#endif 

HGL0BAL CALLBACK _export ListClasses(LPSTR DlgEdClass, UINT DlgEdVersion, 
LPFNL0ADRES LoadResource, LPFNEDITRES EditResource) 

{ 

HGL0BAL ReturnHandle; 

CTLCLASSLIST FAR ‘Memory; 

ReturnHandle = GlobalAlloc(GHND, sizeof(CTLCLASSLIST)); 

if(ReturnHandle) 

( 

Memory - (CTLCLASSLIST FAR *)GlobalLock(ReturnHandle); 
if(!Memory) 

{ 

G1obalFree(ReturnHandle); 
return FALSE; 

} 

Memory->nClasses = 1; 

Memory->Classes[0].fnRWInfo = Rwlnfo; 

Memory->Classes[0].fnRWStyle = RwStyle; 

Memory->Classes[0].fnFlags = CC_FLAGS_FUNC; 

_fstrcpy(Memory->Classes[0].szClass, CC_CLASS_NAME); 
GlobalUnlock(ReturnHandle); 

} 

return ReturnHandle; 

} 

/* End of File */ 
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this data in the resulting dialog resource, in the position 
where Windows expects to find it. 

Borland's resource compiler, BRC, also supports an addition¬ 
al statement that enables it to compile text descriptions of a 
dialog box even if the descriptions contain private control 
data. For example, here is a .rc fragment that Borland’s 
resource compiler accepts but Microsoft’s doesn’t: 

CONTROL "MyCustom" 

CTLDATA '09ad3423' 

As the example shows, the BRC CTLDATA statement accepts a 
hex string that represents the private control data. To protea 
users from having to deal direaly with hex strings, your cus¬ 
tom control’s “Style” funaion should display a dialog box that 
lets the user enter control data in a different form. 

Documented or Not? 

Since Borland’s tools and Windows itself allow you to take 
advantage of private control data while Microsoft’s tools do 
not, I wondered if Microsoft views this as an undocumented 
feature that could be removed in a future release. Scott 
Skorupa, a member of Microsoft’s excellent CompuServe sup¬ 
port team, pointed me to an online document (Microsoft 
Knowledge Base article Q88680) which contains the complete 
documentation for the dialog resource, including the private 
control data field. The article is an explicit correction to the 
printed documentation. 
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Be aware, however, that the Knowledge Base article incor- 
realy states that to use the control data area, you must con- 
strua your own dialog template on the fly and call one of the 
“indirea” dialog box functions to display it — in fact, all you 
need to do is buy Resource Workshop to take advantage of 
the control data area. A flaw in Microsoft’s otherwise very 
good CompuServe support is a tendency to ignore solutions 
provided by other vendors. For example, back when 
Microsoft’s was the only major Windows compiler that did not 
handle large-model Windows programs very well, Microsoft 
support heavily discouraged customers from writing large- 
model Windows programs. After Microsoft C/C++ v7.0 finally 
caught up with the competition on this score, Microsoft sup¬ 
port suddenly decided that large-model Windows programs 
were OK after all. 

Given the Knowledge Base documentation from Microsoft 
and the faa that a major vendor like Borland is using the 
feature, it seems reasonable to classify the control data area 
as a documented part of Windows and to rely on its presence 
in future versions of the operating system. If this is the case, 
perhaps the feature will be documented by all Windows com¬ 
piler vendors in the future, and Microsoft will update their 
dialog editor and resource compiler to provide access to it. 

Vendor-Independent Custom Controls 

My goal is to produce custom controls that work well with 
Borland's new dialog editor interface but are still compatible 
with Microsoft’s old interface. Of course, if the control really 
needs private control data, then I have to give up on trying to 
be Microsoft-compatible. Borland’s interface adds one new 
data struaure, CTLCLASSLIST (returned by the new Class- 
Info()), and adds to two other data structures, CTLTYPE 
(returned by the Info function) and CTLSTYLE (returned by the 
“Style” funaion). 

Since the Borland data struaures are a superset of the 
Microsoft data struaures, you can just create the Borland data 
struaures and use them for both sets of interface funaions. 
You do have to define one bitmap and one cursor if you want 
your custom control to be displayed well in the Resource 
Workshop user interface. If you want to forgo supplying the 
bitmap and cursor, then you can leave out the Class Info () 
funaion and simply name your interface functions and export 
them symbolically as described earlier. 

I also want to be able to switch easily from a standalone 
DLL custom control to one that can be linked direaly into my 
application. To do this, I define a Register() and an Un- 
registerf) function in my custom control. My dialog interface 
code calls the first of these funaions when the DLL is loaded 
and the second when it is unloaded. My application also calls 
these funaions at startup and shutdown. 

A Code Template 

Although in theory adding a dialog editor interface to a 
custom control should be simple, in praaice 1 found it to be 
fairly tedious. There are a lot of details to attend to and trying 
to be compatible with both Borland and Microsoft dialog 
editors adds complexity. I also noticed that, while everyone 
seems to start from scratch to build their own, the dialog 
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editor interface code for any one custom control looks 
remarkably like that of all the others. 

In search of an easier way and after some experience 
working with custom controls —I built a code template. While 
fairly cmde (it only allows one custom control and one sub- 
type), the template handles most of the hassle of building a 
dialog editor interface that works well with both Microsoft and 
Borland tools and that is independent enough from the “real” 
custom control code that it can be easily “snapped off when 
you want to link your control directly to an application. 

The code template consists of two files: ccdlg.h (Listing 1) 
and ccdlg.c (Listing 2). To use the code template, you first 
modify the definitions in ccdlg.h to contain the appropriate 
values for your custom control. The file contains comments to 
help document what each of the items 
is, and the definitions are arranged in 
order so that the ones you most need 
to tailor appear first The file contains 
the values I used to build a dialog 
editor for my drag-and-drop custom 
edit control (DndEdit). 

ccdlg.h contains only four things 
that you absolutely must change. First, 
set CC_NAME to the class name you will 
use for your custom control; the code 
template uses this name to construct 
implicit names for a variety of objects. 

Second, set CC_CLASS_NAME to a quoted 
version of the same name (I am 
ashamed to say that I could not easily 
figure out how to use the preprocessor 
to generate this value implicitly — per¬ 
haps a kind reader will supply the 
answer). Third, set CC_DEFAULT_STYLE 
to the default style bits for your control. 

The code template only supports one 
control subtype, so you can only specify 
one set of defaults. Finally, set the 
values in CcFlags[] to contain the bit 
values and string names of all the style 
bits your custom control defines. You 
will probably want to alter some other 
values as well, but these four represent 
the minimum requirement 

What do you get in return for set¬ 
ting three macro definitions and enter¬ 
ing a table? First, you don’t have to 
write a “Flags” function. Given the Cc- 
Flags[] array, ccdlg.c contains all the 
code to handle this function. Second, 
you don't have to write an “Info” func¬ 
tion. ccdlg.c uses the macro definitions 
in ccdlg.h to handle returning a data 
structure with the correct values to the 
dialog editor. Third, you don't have to 
write a “Style" function (although you 
do still have to implement a dialog box, 
which is the hardest part). 


ccdlg.c assumes that you will supply some items based 
on the name of your custom control, as defined by CC_NAME in 
ccdlg.h. The code assumes that you will supply an initializa¬ 
tion function (at a minimum, the function must call Register- 
Class () to register your custom control class name). It as¬ 
sumes that you will supply a 22x22 bitmap for the Resource 
Workshop toolbox (Borland recommends that you use black 
and gray, with a two-pixel white border on the left and top 
and a two-pixel black border on the right and bottom). 
ccdlg.c assumes that you will supply a cursor for Resource 
Workshop to use when the user is dragging and dropping an 
instance of your custom control, ccdlg.c really cannot help 
you much in implementing your “Style" dialog box, so you 
must supply a dialog box and a dialog function. 
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Of course, your dialog box function needs access to the 
data and function pointers that were passed to the “Style" 
function by the dialog editor. For this reason, ccdlg.c loads 
the pointers into a data structure (CC_INIT_DIALOG) and pas¬ 
ses a pointer to it via DialogBoxParam(). Your dialog box pro¬ 
cedure will receive this parameter in the UM_INITDIALOG mes¬ 
sage. ccdlg.c also sets a flag in the data structure indicating 
whether or not the extended Borland interface was being 
used. You could conceivably use this flag to create a control 
that works correctly with or without the ability to use private 
control data (or at least emits an error message when used 
with the Microsoft tools). 

To illustrate the use of the code template, suppose you are 
implementing a custom control called “Foo." To get your dialog 
editor interface going, here’s what you'll need to do: 

1) Alter at least the first four items in ccdlg.h. 

2) Supply (in a separate file) a function called “FooRegister” 
which will be called at startup. 

3) Supply a function called “Foollnregister,” which will be 
called when the DLL is unloaded. 

4) Supply a dialog template called “Foo_Dialog.” 

5) Supply a dialog procedure called “FooDialog”, the 
procedure's UM_INITDIALOG message will have an IParam 
that is a far pointer to a structure of type 

CC INITDIALOG. 


6) Create a toolbox bitmap called “Foo_Bitmap." 

7) Supply a cursor called “Foo_Cursor." 

Summary 

It takes only a little extra effort to give your custom con¬ 
trol a flexible, vendor-independent dialog editor interface. 
With some advance planning, you can also structure your 
code to easily generate either a custom control DLL or a cus¬ 
tom control object module to statically link into your applica¬ 
tion. Private control data gives you an extra degree of 
flexibility in designing your custom control. We may hope that 
the next release of Microsoft's resource tools will be more 
competitive and will support both the enhanced dialog editor 
interface and access to private control data. If that happens, 
and if Borland fixes their header file anomalies, it will be 
easier than ever to produce vendor-independent custom con¬ 
trols. 

Most of my Resource Workshop questions were answered 
in the appropriate Borland CompuServe forum (GO BCPPWIN). I 
thank Peter D. Eden for supplying all the detailed information 
about how Resource Workshop provides backward com¬ 
patibility with the old dialog editor interface. □ 


Borland Header File Problems 


While trying to make custom controls work with both 
Microsoft and Borland compilers and tools, I ran into a 
problem: the code that had compiled with Microsoft C/C++ 
v7.o produced various warning and error messages when 
compiled with Borland C++ v3.1. Even a file containing 
only the following two lines of code would not compile: 

linclude <windows.h> 
linclude <custcntl .h> 

Eventually, I discovered that the problem went away if I 
did not compile with both “ -DSTRICV and “-DMIN- 
VER=0x0300.” “-DSTRICV enables strict type checking, 
which is very useful for helping the compiler spot poten¬ 
tial coding errors. “-DWINVER=Ox0300" is the macro you 
define if you want to make sure the code you produce 
will work with both Windows 3.0 and Windows 3.1. This 
seems like a flat-out bug to me, but I got the following 
input from Lee Cantey at Borland: 

“These header files (commdlg.h, etc.) were 
designed to let people develop for Windows 3.0 and 
use the redistributable DLLs that became part of Win¬ 
dows 3.1. The header file is using WINVER to decide 
what version of WIN DOWS. H is being used. If WINVER 
isn't set or is less than 0x030A then the assumption is 
made that the Windows 3.0 header file is present and 


that some of the Windows standard types that the 
header file uses (ones new in 3.1) are not available. 

“This works fairly well unless STRICT is defined and 
WINVER is set for Windows 3.0. The code doesn’t hand¬ 
le this situation because STRICT doesn’t make sense for 
the Windows 3.0 windows, h header file. 

“What you are asking for is to make it STRICT and 
only use Windows 3.0 features. This uses WINVER in a 
different way, which is to limit the functionality available 
to the Windows 3.0 API. This is its normal usage in 
header files that are common to both Windows 3.0 and 
3.1. 

“An easy way to get this to work is to change the line 
that checks for Windows 3.0 

#if !defined(WINVER) || (WINVER < 0x030a) 

to also make sure that STRICT is not defined: 

#if Idefined(WINVER) || (WINVER < 0x030a) 

&& !defined(STRICT) 

“Of course this change means that you can’t use the 
WIN30.H header file we supply and STRICT but it 
doesn't make sense to anyway." 

Lee indicated that the situation might be handled bet¬ 
ter in a future version of Borland C++. □ 
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DeMystifiers 

Reviewed by Bruce Graves 


MicroQuill's DeMystifiers is a collection of five tools that 
allow you to look closely into Windows and see what’s going 
on in intimate detail. While four of the programs will run in a 
limited fashion under Windows 3.0, Windows 3.1 or above is 
required to take full advantage of DeMystifiers. A complete 
installation requires roughly one megabyte of disk space, and 
(as always) the more memory you've got, the less impart one 
or more resident utilities will have. Depending on the sorts of 
applications you develop, you may find one or more of these 
tools anywhere from merely interesting to absolutely essential. 

Blowup 

A variation on popular pixel-magnification programs, 
Blowup allows you to view any portion of your screen at a 
zoom factor from one to 50. It offers two viewing modes: live 
and capture. If you select the live option, Blowup includes it¬ 
self as part of the desktop and will update its display when¬ 
ever you click on one of its scroll bars. The capture option is 
typically more useful: Blowup hides itself, captures the screen, 
and then allows you to pan and zoom at will. A status bar 
displays the coordinates and RGB value of the pixel under the 
cursor. Blowup's only drawbacks are its speed (scrolling is very 
sluggish) and the fart that you can only zoom by clicking on 
the Blowupl menu option. If you want a magnification factor 
of 10, you'll have to click 10 times. 

Ecologist 

As its name suggests, Ecologist is designed to examine the 
Windows "environment” from three different perspectives: 
Static, Dynamic, and System. Static values never change over 
the course of a given Windows session; these include the ver¬ 
sions of Windows and DOS that are running, the dimensions of 
the desktop and various window components, and the values 
of DOS environment variables. Dynamic data, which Ecologist 
updates continuously, includes the number of tasks running, 
how many timers are available, and the system time. System 
settings are values that the user can control; these include the 
key repeat rate, the desktop colors, various screen saver set¬ 
tings, the font used for icon captions, etc. Ecologist's System 
window acts as a sort of consolidated control panel, allowing 
you to examine the current values as well as set new ones. 


Mechanic 

Mechanic provides four distinct “under the hood” views of 
Windows. The Device Capabilities window allows you to ex¬ 
amine any attached device (such as your video card or printer) 
to determine various properties, such as which graphics 
operations it directly supports, how many colors its palette 
contains, and how the bits that represent these colors are laid 
out in memory. The Driver Capabilities window reveals 
analogous information about device drivers, including the 
resolutions that a printer driver supports and the DLLs that 
must be available for a particular driver to operate. 

A third display, known as the Display Objects window, 
shows all the icons, bitmaps, and cursors that the current dis¬ 
play driver supports. Finally, the Font window allows you to 
interactively experiment with logical font attributes and dis¬ 
plays an example of the actual text that a given set of charac¬ 
teristics will produce. If you've ever had to repeatedly tweak 
parameters in a program in an effort to render "just the right 
font,” you'll recognize how much time Mechanic can save you. 

Colonel 

Similar to Microsoft's Heapwalk, Colonel allows you to in¬ 
spect modules, tasks, resources, and data in memory, as well 
as to free discardable memory blocks. Unlike Heapwalk, 
Colonel uses a tree-like display that operates a lot like the 
Windows File Manager. At the highest level, the names and 
usage counts of all the current modules are displayed, sorted 


Product Information 

DeMystifiers 1.0 
Suggested list price: $129 

MicroQuill Software Publishing Inc 
4900 25th Avenue NE #206 
Seattle, WA 98105 
(206) 525-8218 
FAX: (206) 525-8309 


Bruce Graves is a freelance writer, programmer, and technical editor, specializing in C++ and Windows programming. He has a BS in 
Computer Science from Cornell University. 
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by name, size, or a variety of other options. If you double-click 
on a module, the tree branches out to display the total size of 
the tasks and memory blocks that are associated with that 
module. If you then double-click on either a task or the block 
summary, it expands to show the individual components in 
complete detail. 

Colonel's well-structured display makes it much easier to 
use than Heapwalk; you can even select which font you'd like 
the information presented in. Colonel also offers a memory 
manager overview dialog, which shows you the largest avail¬ 
able block and a variety of paging statistics. Unfortunately, 
Colonel doesn't offer Heapwalk’s GlobalCompact() feature. In 
addition, Colonel caused several exception 13's in tool- 
help.dll when I was using it to debug one of my own 
programs. No other programs, including Heapwalk, seemed to 
be affected, though Colonel refused to run again until I exited 
Windows and started over. 

Voyeur 

When Colonel reveals problems in your program, Voyeur 
can help track them down. Closely akin to Borland’s WinSight, 
Voyeur allows you to select any window - visible or not — 
and examine its class attributes, its individual window at¬ 
tributes, and its message traffic. While WinSight allows you to 
select which messages to monitor by category, such as 
mouse, window, and DDE, Voyeur lets you specify messages 
both individually and by category, which can be very useful 
when you only care about one or two specific messages. 

Voyeur’s information displays are functional, though some¬ 
what cluttered. Its verbose message-output mode, which 
decodes the parameters that are passed with each message, 
is a little too wordy; Borland’s WinSight presents the same 
information in a more readable format Voyeur offers a unique 
feature, however: you can keep its main window on top of all 
other windows. This can be useful when you want to monitor 
the messages that a full-screen application is receiving as they 
arrive, rather than by reading the message log afterwards. 

Conclusion 

DeMystifiers is a useful set of utilities that contains a few 
wrinkles. The documentation is good as far as it goes, though 
it assumes a very thorough knowledge of Windows internals. 
Specific suggestions on how to use each program to catch 
frequently encountered bugs or solve common problems 
would be useful. The online help is very similar to the manual, 
though it isn't indexed. As a result, the Search function is dis¬ 
abled —a serious flaw in any commercial product. 

If you can live with these omissions and with the Colonel 
utility's causing an occasional exception 13, consider adding 
DeMystifiers to your Windows programming toolbox. It reveals 
a lot about how any program interacts with Windows, and in 
many cases it's much easier and more intuitive to use than a 
source-level debugger. □ 
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Paul Bonneau 


I n the October 1992 Q&A (vol. 3, no. 10) I answered a question using the system 
timer. I have since received a couple of questions about my answer. The first 
question has to do with the number of system timers. In the column I stated that 
“Windows has only one system timer.” In their description of SetSystemTimerf) in 
Undocumented Windows (Addison-Wesley, 1992), however, Schulman, Maxey and 
Pietrek report that "USER provides 16 application timers in version 3.0, and 32 in 
version 3.1. Timers are entries in an array of structures within USER'S default data 
segment. However, the array is not 16 entries in size in version 3.0, it is 18. In 
version 3.1 it is 34. The extra two entries in both versions are only available to this 
function, not to the documented SetTimerf) function.” 

Undocumented Windows is right, there are up to two additional system timers. I 
really should have said that Windows' built-in controls use only one system timer. 

The second question concerns my statement that a built-in control must have 
the focus before it uses a system timer. While this is true, I forgot to add an impor¬ 
tant fact. 

A scroll bar can be created either as a child control or as a property of a window. 
When a window is created with the WS_HSCROLL or US_VSCROLL (or both) styles, the 
scroll bar is not implemented as a child control. Furthermore, if the user clicks on a 
control's scroll bar when another control has the focus, the focus is not moved to 
the control containing the scroll bar. Here comes the clincher: regardless of the type 
of scroll bar, a system timer is used when the the user clicks on any part of the 
scroll bar except the thumb. However, before allocating the system timer, the scroll 
bar code does capture the mouse, so that it can receive mouse movement events 
even when the mouse cursor is not over the scroll bar. In light of this, to be totally 
robust, a custom control should check both that the mouse is not captured (Get- 
Capture () returns null), and that another window does not have the focus (Get- 
Focus () returns either null or the current window) before allocating a system timer. 


Send questions to Paul via Internet 
as paul@rdpub.com-, 
from CompuServe: 

>INTERNET: paul@rdpub. com-, 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2743. 


Paul Bonneau is a Senior Software Design Engineer at Microsoft He developed a 
library used in several Microsoft products and was a developer of HyperChem, a 
molecular modeling system marketed by Autodesk. The opinions expressed in Paul’s 
column are his alone and do not necessarily reflect those of Microsoft 





















Listing 1 systimer.c 


j*★★★★★★★*★★*****★*★★★★***★★******★★**★★★**★*★**★*★*★*j 

j***★**★★****★★★★★★★★★***★★★★★*★*★***★**★★*★******★★**j 

/* systimer.c */ 

/* — Main window procedure. */ 

/* — Test application and system timer allocation. */ 

j*****************************************************j 

/***************************************************** j 

t 

switch (wm) 

linclude <windows.h> 

( 

finclude “systimer.h" 

default: 

return DefWindowProc(hwnd, wm, wParam, IParam); 

/* Private. */ 


LONG CALLBACK MainWndProc(HWND, UINT, WPARAM, LPARAM); 

case WM COMMAND: 

VOID PaintWnd(HWND); 

switch (wParam) 

/ 

/* Imports. */ 

default: 

BOOL WINAPI KillSystemTimer(HWND, UINT); 

return 

UINT WINAPI SetSystemTimer(HWND, UINT, UINT, TIMERPROC); 

DefWindowProc(hwnd, wm, wParam, IParam); 

HINSTANCE hins; /* Instance of app. */ 

case idmGet: 

int ctmr; /* # timers allocated. */ 

for (ctmr * 0; 

int ctmrSys; /* # sys timers allocated. */ 

SetTimer(hwnd, ctmr + 1, 1000, NULL); 
ctmr++) 

/* Class name. */ 

; 

char szApp[] = "SysTimer"; 

break; 

int PASCAL 

case idmFree: 

WinMain(HINSTANCE hinsThis, HINSTANCE hinsPrev, 

for (; ctmr > 0; ctmr—) 

LPSTR lszCommand, int wShowWindow) 

KillTimer(hwnd, ctmr + 1); 

! ***************************************************** j 

break; 

/* -- Entry point. */ 


f*****************************************************/ 

( 

case idmSysGet: 

for (ctmrSys = 0; 

MSG msg; 

SetSystemTimer(hwnd, ctmrSys + 1, 1000, 

HWND hwnd; 

NULL); ctmrSys++) 

hir.s = hinsThis; 

* 

break; 

if (IhinsPrev) 


{ 

case idmSysFree: 

WNDCLASS wcs; 

for (; ctmrSys > 0; ctmrSys--) 

KillSystemTimer(hwnd, ctmrSys + 1); 

wcs.style = CS HREDRAW | CS VREDRAW; 

break; 

wcs.lpfnWndProc = MainWndProc; 

) 

wcs.cbClsExtra = 0; 


wcs.cbWndExtra = 0; 

InvalidateRect(hwnd, NULL, TRUE); 

wcs.hlnstance = hins; 

break; 

wcs.hlcon = NULL; 


wcs.hCursor = LoadCursor(NULL, IDC ARROW); 

case WM DESTROY: 

wcs.hbrBackground = (HBRUSH)(COLOR WINDOW + 1); 

PostQuitMessage(O); 

wcs.lpszMenuName = szApp; 

break; 

wcs.lpszClassName = szApp; 


if (!RegisterClass(&wcs)) 

case WM PAINT: 

return FALSE; 

PaintWnd(hwnd); 

) 

break; 

if (!(hwnd » CreateWindow(szApp, "Timer Test", 

/ 

WS OVERLAPPEDWINDOW, 

return 0; 

CW USEDEFAULT, CW USEDEFAULT, 

1 

GetSystemMetrics($M CXSCREEN) / 2, 


GetSystemMetrics(SM CYSCREEN) / 4, 

VOID 

NULL, NULL, hins, NULL))) 

PaintWnd(HWND hwnd) 

return FALSE; 

j **★★★★★★★**★**★★★★★*★★★★★★★★★★*★★**★*★★★★*****★★★*★★* j 

/* -- Paint the main window's client area. */ 

ShowWindow(hwnd, wShowWindow); 

/* -- hwnd : Window to paint in. */ 

UpdateWindow(hwnd) ; 

y*****************************************************y 

/ 

while (GetMessage(&msg, NULL, NULL, NULL)) 

PAINTSTRUCT wps; 

{ 

char szBuf[100] ; 

TranslateMessage(&msg) ; 


DispatchMessage(&msg) ; 

BeginPaint(hwnd, &wps); 

1 

wsprintf(szBuf, "Timers allocated : %d", ctmr); 

TextOut(wps.hdc, 0, 0, szBuf, lstrlen(szBuf)) ; 

return msg.wParam; 

wsprintf(szBuf, "System Timers allocated: %d", ctmrSys); 

) 

TextOut(wps.hdc, 0, HIWORD(GetDialogBaseUnits()), 
szBuf, Istrlen(szBuf)) ; 

LRESULT CALLBACK 

EndPaint(hwnd, &wps); 

MainWndProc(HWND hwnd, UINT wm, WPARAM wParam, 

1 

LPARAM IParam) 

/* End of File */ 
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Finally, the Undocumented Windows assertion that “USER 
provides 16 application timers in version 3.0, and 32 in version 
3.1" is not exactly correct. I wrote a small application to test 
application and system timer allocation. There are four choices 
on the test application’s only popup menu: “Allocate timers,” 
“Free timers,” “Allocate sys timers,” and “Free sys timers.” The 
application displays two counts in its client area: the total 
number of application timers it has allocated, and the total 
number of system timers it has allocated. Picking “Allocate 
timers” allocates application timers until SetTimer() fails. 
Similarly, "Allocate system timers" allocates system timers 


Listing 2 systimer.h 


y***************************************************** y 

/* systimer.h */ 

/* — Resource interface to SysTimer program. */ 

y*****************************************************y 

Idefine idmGet 0x1000 

Idefine idmFree 0x1001 

Idefine idmSysGet 0x1002 

Idefine idmSysFree 0x1003 

/* End of File */ 


Listing 3 systimer.rc 


y**★**★★★*★*★*★★*★*★*★★★★*★*****★*★★★★**★********★**★*y 
/* systimer.rc */ 

/* -- Resource file for SysTimer program. */ 

j***************************************************** j 

linclude <windows.h> 
linclude "systimer.h 1 ' 


SysTimer MENU 

BEGIN 

POPUP "&Test" 
BEGIN 




MENUITEM 

"&A1locate 

timers”, 

idmGet 

MENUITEM 

"&Free timers", 

idmFree 

MENUITEM 

"&A1locate 

sys timers”, 

idmSysGet 

MENUITEM 

END 

"&Free sys 

timers”, 

idmSysFree 


END 


Listing 4 systimer.def 


;; systimer.def 

;; -- Linker definition file for SysTimer. 


NAME SysTimer 

DESCRIPTION 'Icon Extraction Demo' 

EXETYPE WINDOWS 

STUB 'WINSTUB.EXE' 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 1024 

STACKSIZE 10240 

EXPORTS 

MainWndProc @1 
IMPORTS 

SetSystemTimer=USER.ll 

KillSystemTimer=USER.182 
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until SetSystemTimer() fails. “Free timers" and "Free system 
timers" free all the application's allocated application and sys¬ 
tem timers, respectively. After each operation, the client area 
is updated to show the new counts. 

With no timers allocated, picking "Allocate timers” allocates 
31 application timers and subsequently picking “Allocate sys¬ 
tem timers" allocates 2 system timers. The missing timer is a 
system timer allocated by Program Manager during its call to 
InitTaskf). With no timers allocated, if you first pick “Allo¬ 
cate system timers,” 32 system timers get allocated; sub¬ 
sequently picking “Allocate timers” only succeeds in allocating 
1 application timer (with Program Manager holding an extra 
system timer). So there are up to 32 application timers avail¬ 
able, depending on the number of system timers in use. It 


Listing 6 syskey.c 


/* 

-- lszSection : Name of section in .ini file. 

*/ 

/* syskey.c 

*/ 

/* 

-- lszKey : Key to look for in section. 

*/ 

/* -- Dll for use by Microsoft Setup Utility to 

*/ 

/* 

-- lszValue : Value of key to look for. 

*/ 

/* place a key-value pair in the system.ini file 

*/ 


/* the avoid duplicate key-value pairs. 

*/ 


{ 


/★★★★★★★★★★★★★★★★★★★★Ik******************************** j 


int nfd = -1; 





int wVal = -1; 


linclude <windows.h> 



int cchKey * 1strlen(lszKey) ; 


linclude <windowsx.h> 



int cchSection » 1 strlen(l szSection) ; 


linclude <limits.h> 



int cchValue - 1strlen(lszValue) ; 

int cch; 


/* Private. */ 



char szKeyValuefcbKeyValueMax] ; 


BOOL FlsWhite(int) ; 



LPSTR lpch; 


LPSTR LpchSkipWhite(LPSTR) ; 



BOOL fGotSection; 


int WReadlineLsz(int, LPSTR, int); 



/* Make sure key-value pair isn't too big. */ 


/* Exports. */ 



if (cchKey + cchValue + 2 >= sizeof szKeyValue) 


int CALLBACK export LibMainfHINSTANCE, WORD, WORD, 



goto FExistsSysIniKeyValueExit ; 


LPSTR); 





int CALLBACK export WEP(int); 



/* Search for key-value pair in file. */ 





if ((nfd = lopen(lszFile, READ)) ■« -1) 


Idefine cbKeyValueMax 1024 /* Max. .ini line. */ 


goto FExistsSysIniKeyValueExit ; 


int CALLBACK export 



fGotSection = FALSE; 


LibMain(HINSTANCE hinsThis, WORD sel, WORD cbHeap, 



for (;;) 


LPSTR lsz) 



{ 


/★**************************************************** i 


int chSav; 


/* — Entry point. 

*/ 




^★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★********************y 


switch (WReadLineLsz(nfd, szKeyValue, 


{ 



sizeof szKeyValue)) 


return TRUE; 



{ 


) 



default: 





goto FExistsSysIniKeyValueExit ; 


int CALLBACK _export 

WEP ( int nExitCode) 



case FALSE: 


j*****************************************************J 


wVal * 0; /* Key not found. */ 


/* -- Exit proc. 

*/ 


goto FExistsSysIniKeyValueExit ; 


/★★★★★★★★★★★★★★★★★A-***********************************/ 




{ 



case TRUE: 


return 1; 

} 



break; 

} 


int PASCAL export 



if (szKeyValue[0] == '[') /* New section? 

*/ 

FExistsSysIniKeyValue(LPSTR lszFile, LPSTR IszSectior 

, 


{ 


LPSTR lszKey, LPSTR lszValue) 



if (fGotSection) 


/***************************************************** J 


{ 


/* -- Test if the given key-value pair exists in the 

*/ 


wVal = 0; 


/* given ini file. 

*/ 


goto FExistsSysIniKeyValueExit; 


/* -- Return 1 if so, else 0. 

*/ 


) 


/* -- Return -1 in case of error (file does not 

*/ 




/* exist, out of memory, etc). 

*/ 


if (szKeyValue[cchSection + 1] == ']') 


/* -- lszFile : Full pathname of .ini file. 

*/ 


{ 



Listing 5 makefile.tmr 


####################################################### 
I# makefile.tmr ## 

## -- Project file for SysTimer app. #1 

fffffffffffffffffffffffffffffffffffffffffffffffffffffff 
all: systimer.exe 

systimer.obj: systimer.c 

cl -c -AM -G2w -Od -Zdpe -W3 -DSTR1CT systimer.c 

systimer.exe: systimer.obj systimer.def systimer.rc \ 
makefile.tmr 

link /NOD systimer,,, libw mlibcew, systimer.def 
rc $(DEFS) systimer 
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would have been more accurate to say that “USER provides 
up to 16 application timers in version 3.0, and up to 32 in 
version 3.1." 

My timer tester is implemented in listings 1 through 5. List¬ 
ing 1 is the C source, Listing 2 the header file for the menu 
IDs, Listing 3 the resource file for the menu, Listing 4 the linker 
module definition file, and Listing 5 the makefile. 

Q l am writing an installation program for the drivers 
which accompany a hardware board. One of the files is 
a VxD, and a device= line must be added to the [386Enh] 
section of the system.ini file. I’m using the MSSETUP and 
MSTEST utilities which come with the Windows 3.1 SDK. 

The problem is this: While the MSTEST script language in¬ 
cludes a function called CreateSysIniKeyValue() which can 
create a non-unique key entry, there is no corresponding call 
to find out what key entries already exist. This can lead to 
trouble, as duplicate device = lines can cause Windows not to 
start. 

Looking through the regular Windows API, I can find no 
function that can tell me what all of the device = entries are. 
I could read it in as a standard text file, but this seems to 
violate the intended interface for. ini files. Is there any easier 
way to do this? 

One other question: I have also been unable to find an API 
function that duplicates the behavior of MSSETUP's CreateSys¬ 
IniKeyValue () . Is there such a function? 


Listing 6 continued 


szKeyValuefcchSection + 1] * '\0 1 ; 
if (llstrcmpi(szKeyValue + 1, 
lszSection)) 
fGotSection * TRUE; 

) 

) 

else if (IfGotSection) 
continue; 

chSav = szKeyValuefcchkey]; 
szkeyValuefcchKey] - '\0'; 
if (IstrcmpifszKeyValue, lszKey)) 
continue; 

/* Skip white space. */ 

szKeyValuefcchKey] = chSav; 

lpch = LpchSkipWhitefszKeyValue + cchKey); 

/* Must be an equal sign. */ 
if (*lpch ! = '=') 
continue; 

/* Skip white space. */ 

lpch = LpchSkipWhite(lpch + 1); 

/* Strip trailing white space. */ 
if ((cch = lstrlen(lpch)) < cchValue) 
continue; 

for (;;) 

if (! FIsWhi te(l pch [--cch])) 
break; 
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Listing 6 continued 


lpch[++cch] * 1 \0 1 ; 

if (!lstrcmpi(lszValue, 1 pch)) 

{ 

wVal = 1; 

goto FExistsSysIniKeyValueExit; 

) 

} 

FExistsSysIniKeyValueExit: 
if (nfd !=■ -1) 

_lclose(nfd); 
return wVal; 

} 


BOOL 


FIsWhite(int ch) 

j*****************************************************/ 

/* -- Return TRUE if the given character is white */ 
/* space. */ 

/* -- ch : Character to test. */ 


{ 

return ch «* 1 1 || ch == 1 \t 1 || ch == '\n' || 
ch == '\f' || ch - '\r 1 ; 

} 


LPSTR 

LpchSkipWhite(LPSTR lpch) 

f*****************************************************/ 

/* -- Skip leading white space. */ 

/* -- lpch : String to test. */ 

^*****************************************************I 

f 

while (*lpch) 

if (!FIsWhite(*1pch++)) 
break; 


return --lpch; 

} 


int 

WReadLineLsz(int nfd, LPSTR lpch, int cb) 


/* -- Read a line from the given file. */ 
/* -- Return false if no more to read. */ 
/* -- Return -1 if current line exceeds buffer size. */ 
/* -- nfd : File descriptor. */ 
/* -- lpch : Buffer to read into. */ 
/* -- cb : Length of buffer. */ 


{ 

for (;;) 

{ 

if (!cb--) 
break; 


if (_lread(nfd, lpch, 1) < 1) 
return FALSE; 

if (*lpch++ == '\n') 

{ 

*--lpch * ‘\0 1 ; 
return TRUE; 

} 


return -1; 

} 

/* End of File */ 


A I think this is an oversight by Microsoft. I used V Com¬ 
munications Sourcer to disassemble mscomstf.dll and 
msinsstf.dll. These DLLs contain the functions used by the 
setupapi.inc Test BASIC routines. It turns out that Create- 
SyslniKeyValue() is a Test BASIC subroutine that uses the 
msinsstf.dll function FCreateSysIniKeyValue(), which in 
turn is implemented by calling OpenFile() to open sys¬ 
tem. ini and _lwrite() to write a new line to it. I agree that 
it would be desirable to find a Windows or setup toolkit func¬ 
tion to perform the required work, but since no such function 
exists, I don't think you have much choice but to revert to the 
text file approach. 

This may well break in the next version of Windows, espe¬ 
cially as Microsoft moves more and more information into the 
registration database, but for now you really have little choice. 
I coded up a DLL and Test BASIC include file to make sure this 
approach will work. I was concerned because I knew that 
opening win. ini would not work, since a copy of it is buf¬ 
fered in memory (reading from a stale disk image is not a 


Listing 7 syskey.rc 


j***************************************************** J 

/* syskey.rc */ 

/* -- Empty resource file. */ 

f*****************************************************j 


Listing 8 syskey.def 


syskey.def ; 

— Module definition file for .ini file key-value ; 
detector. ; 


LIBRARY SysKey 

EXETYPE Windows 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD SINGLE 

HEAPSIZE 1024 

EXPORTS 

WEP @1 RESIDENTNAME 

FExistsSysIniKeyValue @2 


Listing 9 makefile, key 


####################################################### 
## makefile.key ## 

## -- Project file for SysKey Dll. ## 

####################################################### 
all: syskey.dll 

.c.obj: 

cl -c -ASw -G2w -Od -Zdpe -W3 -DSTRICT $(DEFS) $< 
syskey.obj: syskey.c 

syskey.dll: syskey.obj syskey.rc syskey.def 

link /NOD/map syskey libentry, syskey.dll,, \ 
libw sdllcew, syskey.def 
rc $(DEFS) -fe syskey syskey.dll 
mapsym syskey 
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particularly good idea). But system, ini is not treated as a nor¬ 
mal .ini file. It is not read by GetPrivateProfileStringf), 
and is not written to by Windows itself. And since the setup 
kit has set a precedent by opening and writing to system, ini, 
reading the disk image should be safe. 

Listing 6 is the C source to Syskey, a DLL that exports a 
single function, FExistsSysIniKeyValue(). This routine ac¬ 
cepts the path of the system, ini file, the name of the section 
to examine, the name of the key, and the particular value of 
that key to search for. It returns 1 if the key-value pair is 
found, -1 if an error occurs (such as being unable to open the 
file), or 0 if the key-value pair is not found. The DLL is imple¬ 
mented without reliance on any of the standard C runtime 
library routines. This results in a very small DLL (syskey.dll is 
4,608 bytes long). The source itself is rather dull. It scans until 
the required section is found (a section begins on a new line 
and is enclosed in square brackets), then searches for the re¬ 
quired key-value pair. The routine checks for the next section 
or end of file to terminate the search. 

FExistsSysIniKeyValue() relies on some small helper 
routines in lieu of the standard C library. FIsUhite() returns 
true if the character passed to it is white space, LpchSkip- 
Uhite() skips leading white space and returns a pointer to 
the first non-white character of a string, and UReadLineLsz() 
reads a line of ASCII text into the supplied buffer. Listing 7 is 
an empty resource file, Listing 8 the linker module definition 
file, and Listing 9 the makefile. 


Listing 10 is a Test BASIC include file that implements the 
cover subroutine CreateUniqueSysIniKeyValue(). It is a 
blatant rip-off of the function CreateSysIniKeyValuef) from 
setupapi.inc. It performs the same work as its ancestor, with 
the additional check for an already existing key-value pair. 
Only if the key-value pair does not already exist does it call 
FCreateSysIniKeyValuef) to do the actual work. 

Q A friend and I have been attempting to get an MDI child 
window to display without the system menu box and 
the minimize and maximize buttons. 

If you have a solution or any ideas, or even a direction to 
pursue, we would be interested in hearing your thoughts. 

My friend works in Borland C++ using OWL and I am 
programming in Turbo Pascal for Windows using OWL. While 
we would prefer the solution in either format, we are not too 
picky —we will gladly accept a solution in any language. 

Richard L Rosenheim 
5712 North Carta Blanca Road 
Paradise Valley, A 1 85253 

A This is a bit of a problem. The minimize, maximize, and 
system menu icons are specified by supplying the style 
bits US_MINIMIZEBOX, US_MAXIMIZEBOX, and WSJYSMENU, 
respectively, to the CreateUindow() call (or CreateUindow- 
Ex()). But since an MDI child is created by sending the 
UM_MDICREATE message to the MDI client window, you don’t 


Listing 10 syskey. inc 


DECLARE FUNCTION FExistsSysIniKeyValue LIB "syskey.dl1" (szFile$, szSect$, szKey$, szValuei) AS INTEGER 
DECLARE SUB CreateUniqueSysIniKeyValue (szFilet, szSect$, szKey$, szValue$, cmo%) 

•************************************************************************* 

SUB CreateUniqueSysIniKeyValue (szFile$, szSect$, szKey$, szValue$, cmo%) STATIC 
'$ifdef DEBUG 

if FVaTidFATPath(szFiTe$) » 0 then 
n% = 1 

elseif FValidInfSect(szSect$) « 0 then 
n% = 2 

elseif szKey$ = then 
n% * 3 

else 

n% - 0 
end if 

if n% > 0 then 

BadArgErr n%, "CreateUniqueSysIniKeyValue 11 , szFile$+“, “+szSect$+", "+szKey$+“, “+szValue$+", “+STR$(cmo%) 
end if 

'Sendif "DEBUG 

n% = FExistsSysIniKeyValue(szFile$, szSect$, szKey$, szValue$) 
if n% = -1 then 
'$ifdef DEBUG 

StfApiErr saeFail, "CreateUniqueSysIniKeyValue”, szFile$+“, “+szSect$+“, “+szKey$+“, "+szValue$ 

'$endif "DEBUG 

ERROR STFERR 
elseif n% * 0 then 

if FCreateSysIniKeyValue(szFile$, szSect$, szKey$, szValue$, cmo%) = 0 then 
•$ifdef DEBUG 

StfApiErr saeFail, "CreateSysIniKeyValue", szFile$+“, "+szSect$+", "+szKey$+", "+szValue$+", “+STR$(cmo%) 
'$endif "DEBUG 

ERROR STFERR 
end if 
end if 
END SUB 
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Listing 11 mdi.c 


!★***★★*★★★★*★**★******★★★★****************★★*****★*★★i 

wcs.hlnstance * hinsThis; 

/* mdi.c */ 

wcs.lpfnWndProc - LocalEditWndProc; 

/* — Demo MDI app uses a child edit control. */ 

wcs.lpszClassName ■ szLocalEdit; 

j******************* **********************************j 

if (!RegisterClass(&wcs)) 

#include <windows.h> 

return FALSE; 

} 

linclude <windowsx.h> 


linclude "mdi.h" 

/* Create the frame. */ 

/* Globals. */ 

if (!(hwnd * CreateWindow(szFrame, "MDI", 

WS OVERLAPPEDWINDOW, 

HWND hwndClient; /* MDI client. */ 

CW USEDEFAULT, 0, CW USEDEFAULT, 0, 

HWND hwndActive; /* Active MDI child. */ 

NULL, NULL, hinsThis, NULL))) 

HWND hwndEdit; /* Local edit window. */ 

return FALSE; 

WNDPROC lpfnEdit; /* Edit window proc. */ 


/* Class names. */ 

/* Create the edit control at top left. */ 
GetClientRect(hwnd, &rect); 

char szFrame[] = "frame"; /* Frame. */ 

hwndEdit ■ CreateWindow(szLocalEdit, NULL, 

char szChildf] ■ "child"; /* MDI child. */ 

WS BORDER | WS CHILD | ES MULTILINE | 

char szLocalEdit[] ■ “ledit"; /* Local edit. */ 

WS VISIBLE | WS CLIPSIBLINGS, 

LRESULT CALLBACK ChildWndProc(HWND, UINT, WPARAM, 

0, 0, rect.right / 2, rect.bottom / 2, 
hwndClient, (HMENU)l, hinsThis, NULL); 

LPARAM); 


LRESULT CALLBACK FrameWndProc(HWND, UINT, WPARAM, 

ShowWindow(hwnd, wCmdShow); /* Show frame. */ 

LPARAM); 

while (GetMessage(&msg, NULL, 0, 0)) 

LRESULT CALLBACK LocalEditWndProc(HWND, UINT, WPARAM, 

if (ITranslateMDISysAccel(hwndClient, &msg)) 

LPARAM); 

{ 

int PASCAL 

TranslateMessage(&msg); 

DispatchMessage(&msg); 

WinMain(HINSTANCE hinsThis, HINSTANCE hinsPrev, 

} 

LPSTR lszCmdLine, int wCmdShow) 


y*****************************************************y 

return msg.message; 

/* — Entry point. */ 

} 



{ 

LRESULT CALLBACK 

MSG msg; 

FrameWndProc(HWND hwnd, UINT wm, WPARAM wParam, 

HWND hwnd; 

LPARAM IParam) 

RECT rect; 


/* If this is the first instance of the app. */ 

/* -- Frame window procedure. */ 

y*****************************************************^ 

/* register window classes. */ 

{ 

if (!hinsPrev) 

f 

WNDCLASS wcs; 

switch (wm) 

{ 

default: 

/* Register the frame class. */ 

return DefFrameProc(hwnd, hwndClient, wm, 
wParam, IParam); 

wcs.style ■ 0; 


wcs.lpfnWndProc * FrameWndProc; 

case WM CREATE: 

wcs.cbClsExtra = 0; 

{ 

wcs.cbWndExtra = 0; 

CLIENTCREATESTRUCT ccs; 

wcs.hlnstance = hinsThis; 


wcs.hlcon = LoadIcon(NULL, IDI APPLICATION); 

/* Find window menu where children will be */ 

wcs.hCursor = LoadCursor(NULL, IDC ARROW); 

/* listed. */ 

wcs.hbrBackground * 

ccs.hWindowMenu = GetSubMenu(GetMenu(hwnd), 1); 

(HBRUSH)(COLOR APPWORKSPACE + 1); 

ccs.idFirstChild * 0x1000; 

wcs.lpszMenuName » MAKEINTRESOURCE(idmMDI); 


wcs.lpszClassName * szFrame; 

/* Create the MDI client. */ 

if (!RegisterClass(&wcs)) 

hwndClient = CreateWindow("mdiclient", NULL, 

return FALSE; 

WS CHILD | WS VISIBLE, 0, 0, 0, 0, hwnd, 0, 

/* Register the MDI child class. */ 

GetWindowInstance(hwnd), (LPSTR)&ccs); 

) 

wcs.lpfnWndProc = ChildWndProc; 

break; 

wcs.hlcon = LoadIcon(NULL, IDI APPLICATION); 


wcs.lpszMenuName = NULL; 

case WM COMMAND: 

wcs.cbWndExtra = 0; 

switch (wParam) 

wcs.lpszClassName * szChild; 

( 

if (!RegisterClass(&wcs)) 

default: 

return FALSE; 

DefFrameProc(hwnd, hwndClient, wm, wParam, 

/* Register the local edit class. */ 

OL); 

break; 

GetClassInfo(NULL, "edit", &wcs); 


lpfnEdit = wcs.lpfnWndProc; 

case idmFileNew: 
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get to call CreateWindowO; instead, the MDI manager inside 
USER does. 

You can, however, turn these bits off after the child MDI 
window is created. GetWindowLongO, using GUL_STYLE, can be 
used to retrieve the current style bits for a window. You can 
turn off the required bits by masking them out of the current 
bits, and setting the result back into the window: 


Listing 11 continued 


{ 

/* Make an empty MDI child window. */ 
MDICREATESTRUCT mcs; 

mcs.szTitle = "MDI Child"; 
mcs.szClass * szChild; 
mcs.hOwner * GetWindowInstance(hwnd); 
mcs.x - mcs.cx ■ mcs.y * mcs.cy ■ 
CWJJSEDEFAULT; 
mcs.style = 0; 

/* Tell the MDI Client to create the */ 

/* child. */ 

if (SendMessagefhwndClient, WM_MDICREATE, 

0, (LONG)(LPMDICREATESTRUCT)&mcs)) 
ShowWindow(hwnd, SW_SH0W); 
break; 

) 

break; 

case WM_CL0SE: 

DestroyWindow(hwnd); 
break; 

case WM_DESTR0Y: 

PostQuitMessage(O); 
break; 

case WM_SETFOCUS: 
if (hwndEdit) 

SetFocus(hwndEdit); 
break; 

) 

return 0; 

) 

LRESULT CALLBACK 

ChildWndProc(HWND hwnd, UINT wm, WPARAM wParam, 

LPARAM IParam) 

/* -- MDI child window procedure. */ 

I***★★**★*★***★★*★*★★**★*★★***★**★★******★★★★★***★★**★i 
{ 

switch (wm) 

( 

default: 

break; 

case WM_MDIACTIVATE: 
if (wParam) 

hwndActive = hwnd; 
break; 

case WM_PAINT: 

{ 

PAINTSTRUCT wps; 

HLOCAL hmem; 

BeginPaint(hwnd, Swps); 

if (hmem * (HLOCAL)SendMessage(hwndEdit, 
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Listing 11 continued 


EM GETHANDLE, 0, 0)) 

{ 

{ 

LRESULT lval; 

RECT rect; 


PSTR sz = LocalLock(hmem); 

lval * CallWindowProcflpfnEdit, hwnd, wm, wParam, 

1Param); 

GetClientRect(hwnd, &rect); 


DrawText(wps.hdc, sz, -1, &rect. 

switch (wm) 

DT NOPREFIX | DT WORDBREAK); 

{ 

LocalUnlock(hmem); 

default: 

) 

break; 

EndPaint(hwnd, &wps); 


} 

case WM KEYUP: 

return 0; 

InvalidateRect(hwndActive, NULL, TRUE); 

) 

break; 

return DefMDIChildProc(hwnd, wm, wParam, IParam); 

case WM SETFOCUS: 

) 

BringWindowToTop(hwnd); 
break; 

LRESULT CALLBACK 

) 

LocalEditWndProc(HWND hwnd, UINT wm, WPARAM wParam, 


LPARAM IParam) 

return lval; 

/*****************************************************/ 

1 

/* -- Subclasser for edit window. */ 

/* End of File */ 

/* -- Copy text of edit to active MDI child. */ 

/★**★**★**★★****★*★**★★***★*****★***★★★**★*★★****★★★★★/ 
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SetWindowLong(hwnd, GWL_STYLE, 

GetWindowLong(hwnd, GWL_STYLE) & 

~(WS_MINIMIZEBOX | 

WS_MAXIMIZEBOX | 

WS_SYSMENU)); 

The remaining problem is figuring out when to do this. If you 
clear the unwanted bits after the window is created (i.e., upon 
return from sending the UM_MDICREATE message to the MDI 
client), you will still see the icons. They won't work, but the 
window will have been painted while the bits were present. 
Calling InvalidateRect() with a NULL rect pointer parameter 
will not work, since this only causes the client area to be 
painted. I experimented with DrawMenuBar(), which is used to 
redraw a menu bar, and even tried sending a UM_NCPAINT 
message, but these did not work either. Windows 3.1 has so 
many optimizations to avoid unnecessary repainting that you 
really have to jump through hoops to try and force a non¬ 
client area update. 

You could force a paint by extracting the title bar text and 
resetting it to the same string, but this is clumsy and results 
in flicker. The best solution I found is to clear the bits in the 
WM_NCCREATE case of the child window procedure. By the time 
UM_NCCREATE has been sent, Windows has already set the 
style bits in the child window’s UND structure, but the non¬ 
client area has not yet been painted. After clearing the bits, 
make sure you pass the message to DefMDIChildProc(), as 
this is a rather critical message for DefMDIChildProc() to 
process. 

Q ln his article “A Drag-and-Drop Edit Control: Part 1" in the 
October 1992 issue (vol. 3, no. 10), Ron Burk posed a 
question. In his implementation of the drag-and-drop edit con¬ 
trol, he would repost a fake HM_M0USEM0VE message to his 
application each time one was received, so long as no other 
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Listing 12 mdi.h 


/*****************************************************/ 
/* mdi.h */ 

/* — Menu ID's. */ 

j *★******★***★**★****★******★★***★★*****★**★★★★★★★**★*/ 

#define idmMDI 1000 /* Main menu id. */ 

fdefine idmFileNew 1001 /* File/New menuitem ID. */ 

Idefine idmDumniy 1002 /* Dummy menuitem ID. */ 

/* End of File */ 


UM_M0USEM0VEs were waiting in his queue. According to con¬ 
ventional wisdom, this should prevent any other application 
from receiving the processor, since the drag-and-drop 
application's queue would always have a waiting message 
each time GetMessage() was called. But Ron noticed that if 
the clock applet was running, it would continue to tick, even 
when the drag-and-drop application was in the message-post¬ 
ing loop. What Ron wanted to know is why were other ap¬ 
plications being allowed to run? 

A The solution to this puzzle lies in understanding the two 
types of message queues used by Windows. There is one 
system message queue into which all hardware input (mouse, 
keyboard, etc.) goes. In addition, each application possesses its 
own local message queue. Messages are removed from the 
system message queue in a strictly ordered, serial fashion. The 
message one position away from the head of the system 
message queue cannot be removed until the message at the 


Listing 13 mdi.rc 


y*****************************************************^ 
/* mdi.rc */ 

/* -- Menu and icon definitions for mdi application. */ 

#include <windows.h> 

#include "mdi.h" 

/* Frame window menu. */ 

idmMDI MENU L0AD0NCALL MOVEABLE DISCARDABLE 


BEGIN 

POPUP 

"&File" 

BEGIN 



POPUP 

MENUITEM 

END 

"&Window“ 

BEGIN 

"&New", 

idmFi1eNew 

END 

MENUITEM 

END 

"&Dummy", 

i dmDuimiy 


head is. Thus if there is hardware input pending for two ap¬ 
plications, the second application cannot receive its input until 
the message for the first has been removed from the system 
message queue. A complication is that the PostMessagef) 
function places a message directly in the queue of the ap¬ 
plication that owns the window to receive the message, 
bypassing the system message queue. 
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Listing 14 mdi.def 


mdi.def 

-- Linker definition file for HDI Demo App. 


NAME MdiDemo 

DESCRIPTION 'MDI Demo' 

EXETYPE WINDOWS 

STUB 'WINSTUB.EXE' 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 1024 

STACKSIZE 10240 

EXPORTS 


ChildWndProc 

@1 

FrameWndProc 

@2 

LocalEditWndProc 

@3 


When an application calls GetMessage() or PeekMessage(), 
another application can be scheduled to run if it has a mes¬ 
sage in its local message queue, even if a message from the 
system message queue cannot be delivered. This means that 
the clock applet can receive UM_TIMER and UM_PAINT mes¬ 
sages from its local queue, even though it cannot receive 
hardware input. If a hardware event occurs for the drag-and- 
drop edit control while it is maintaining a UM_MOUSEMOVE mes¬ 
sage in its local queue, the hardware event cannot get 
delivered, and no other application can receive a hardware 
event message. This is one of the central problems of both 
Windows 3.1 and OS/2 version 2.0., but not in Windows NT. So 
long as a system message queue is used to serialize input, it 
is possible for a single application to prevent any other ap¬ 
plication from receiving hardware input messages. 

Q I am trying to write an MDI program using MFC. This 
application will have an edit-bar like EXCEL. As EXCEL 
does, I want to make my edit-bar dynamically expand 
downwards into the client area if the user enters the text past 
the current width of the edit-bar. I got the expand part to 
work okay, but when the edit-bar expands into the MDI client 
and MDI child window, there is no clipping. The MDI client 
window gets a paint message when I type in the edit-bar and 
it paints itself over the edit-bar (the part that extended into 
MDI client area). 

I have made my edit-bar just a child window, but that 
didn't work. I have tried to create the MDI child windows with 
US_CLIPSIBUNGS, that didn't work. Then I made the edit-bar 
a modeless dialog box, but that didn’t work because when 
the edit-bar became active, the MDI child lost its activation. 
Can you help me with this problem? 

Andy Galassi 
CIS: 76702,317 

A I think the crux of this problem is determining who should 
be the parent of the edit-bar window. If you make the 
main (frame) window the parent, you encounter the problems 
you have already seen due to the interaction of the MDI client 
and the edit-bar (a bad example of sibling rivalry -ouch!). But if 
you make the edit-bar a child of the client, and create it with the 
US_CLIPSIBLINGS style, the result is much better. 


Listing 15 makefile.mdi 


####################################################### 
## makefile.mdi ## 

## -- Project file for MDI Demo app. ## 

####################################################### 
all: mdi.exe 

mdi .obj: mdi.c 

cl -c -AM -G2w -Od -Zdpe -W3 -DSTRICT mdi.c 

mdi.exe: mdi.obj mdi.def mdi.rc makefile.mdi 
link /NOD mdi,,, libw mlibcew, mdi.def 
rc $(DEFS) mdi 


I implemented a little demonstration program, derived 
from Microsoft’s BlandMdi sample application. After creating 
the frame window, the program creates a multiline edit con¬ 
trol half the width and half the height of the client area, at 
the upper left-hand corner of the client. Each time a character 
is entered into the edit control, its contents are displayed in 
the active MDI child. When the edit control receives the focus 
(via the mouse or keyboard), it makes itself the top child win- 
dow (using BringUindowToTopO). This application 
demonstrates entering text into an edit control as the overlap¬ 
ping MDI child processes paint messages. 

Listing 11 is the C source code. The UinMain() function 
registers three classes: one each for the frame window and 
child MDI windows, and a third based on the predefined edit 
class. GetClassInfo() is used to fill a class structure from the 
system edit class. The class name and window procedure are 
replaced with a local name and window procedure before 
being reregistered. This is actually somewhat simpler than 
creating an edit control and subclassing it. The local edit pro¬ 
cedure can perform idiosyncratic actions and rely on the 
original edit window procedure to process the bulk (if not all) 
of the messages. 

When the frame window procedure receives the focus, it 
sets the focus to the edit control. It’s up to you whether to 
keep this behavior. The only reason I put it in was so that I 
could see the edit control on top of any MDI children when¬ 
ever the frame window is activated. The MDI child window 
procedure records the active MDI window by setting the 
global hwndActive whenever it receives a WM_MDIACTIVATE 
with non-null wParam. When the child window procedure 
receives a um_paint message, it gets the edit control’s text 
using EMJGETHANDLE and calls DrawText() to display the text. 
The local edit procedure doesn't do much at all. When it 
receives a WM_KEYUP, it assumes its text has changed, and in¬ 
validates the active MDI child, causing the text to appear in 
the child when it processes the ensuing WM_PAINT. And, as 
already noted, when the edit control receives the focus, it 
makes itself the top child window by using BringWindowTo- 
Top (). 

Listing 12 is a header file for defining menu identifiers, List¬ 
ing 13 a resource file containing the menu definition. Listing 
14 the linker module definition file, and Listing 15 the 
makefile. □ 
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Subclassing with C++ 

Norman L Hills and Davin S. Hills 



Introduction 

Object-oriented programming in C++ offers many advantages — the 
encapsulation of data with functions, inheritance of data and functions, 
etc. The purpose of this article, however, is not to convert you to C++, 
but to demonstrate a method for combining the benefits of C++ objects 
with the Windows API. While many of the most powerful features of 
C++ classes only become apparent with a complete set of classes for the 
Windows environment, the method for hooking a C++ control class into 
Windows demonstrated here can be used for any type of button (or, 
with many changes, for any control). 

Windows has at least one feature of OOP —namely, a dependence on 
message passing to perform its functions. The object-oriented paradigm 
makes it easier to think of Windows entities and functions as existing 
on their own, independent of the sequential time assumptions and 
restraints of traditional programming. The interaction of C++ objects 
seems a natural way of dealing with the event-driven environment of 
Windows message processing. Unfortunately, Windows does not recog¬ 
nize C++ class member functions as valid window processing functions 
without intervention of the kind shown here. This article shows how to 
design C++ objects that interact naturally with the Windows environ¬ 
ment by building VButton, a class that implements buttons with vertical 
text. 

Listing 1 is a simple test program to use the VButton class. It is a 
plain vanilla Windows program, but a few points are worth noting. The 
message loop at the end of UndProcf) gives a main window many of 
the keyboard processing features (Tab, Enter, etc.) found in a dialog box. 
This is a trick borrowed from the Microsoft Systems Journal (Oct. 1992, 
pp. 40-41). Note also that the VButton pointers are static. Since Wnd- 
Proc() is entered for each message, the buttons would vanish if the 
pointers were not static. The pointers are initialized by cc_Vert- 
Button(), rather than the call to new you might expect. The call to new 
occurs in cc_VertButton() and is followed by the call to Startf). The 
subclassing is separated from the constructor so that classes derived 
from VButton will not be subclassed prematurely. 


Norman L Hills is an independent software consultant and developer 
with his own firm, Hills Object Technology, Inc. The firm specializes in 
Windows C++ object-oriented software tools, systems, and consulting. The 
firm developed and distributes the 'Construct" class library for C++ and 
Windows. Mr. Hills has a BS in English from Iowa State University and has 
26 years of computer system design, programming, and management 
experience. He can be reached on CompuServe at 71621, 1352. 

Davin S. Hills is Vice-President and Senior Programmer for Hills Object 
Technology. He has a BS in Chemistry from Drake University. 
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Listing 2 shows the VButton class declaration, while Listing 
4 includes the definition of all VButton class member func¬ 
tions and the constructor 

Windows 3.0 Window Subclassing 

Window subclassing is a powerful way to modify the ap¬ 
pearance of custom controls without assuming complete 
responsibility for drawing the control. This is particularly true 


for buttons, since Windows can handle most of the process¬ 
ing. Unfortunately, subclassing is a topic often misunderstood, 
at least partially because of the definition provided in the 
Microsoft Windows Programmer’s Reference (Section 1.2.10): “A 
subclass is a window or set of windows that belong to the 
same window class, and whose messages are intercepted and 
processed by another window function (or functions) before 
being passed to the class window function." 


Listing 1 vbuttest.cpp 


/* Listing 1 

TranslateMessage(&msg); 

Test program for 

DispatchMessage(&msg) ; 

Windows vertical button class for C++ 

} 

Copyright (c) 1992 Hills Object Technology, Inc. 

All Rights Reserved 

} 

Borland C++ 3.1 compile: 

return msg.wParam; 

bcc -WS vbuttest 

*/ 

linclude <windows.h> 

) 

extern "C" { 

#include "vbutclas.h" 

LRESULT WINAPI export WndProc(HWND hwnd, UINT message, 

linclude "property.cpp" 
linclude "vbutton.cpp" 

WPARAM wParam, LPARAM IParam) { 

static VButton *vertptrl; 

extern "C" ( 

static VButton *vertptr2; 

LRESULT WINAPI _export WndProc(HWND,UINT,UINT,LONG); 

int reply; 

}; 

int PASCAL WinMain(HINSTANCE hlnstance. 

switch(message) ( 

HINSTANCE hPrevInstance, 

LPSTR IpszCmdLine, int nCmdShow) 

case WM_CREATE: 

{ 

vertptrl = cc VertButton(hwnd, 

static char szAppNamef] = "Vertical Button"; 

((LPCREATESTRUCT)lParam)->hInstance, 

HWND hwnd; 

MSG msg; 

102,"&Vertical 1",232,20); 

WNDCLASS wndclass; 

vertptr2 = cc VertButton(hwnd, 

((LPCREATESTRUCT)lParam)->hInstance, 

if (IhPrevInstance) { 

wndclass.style = CS HREDRAW | CS VREDRAW; 

103,"V&ertical 2",132,20); 

wndclass.lpfnWndProc = WndProc; 

vertptrl->Focus(); // Start Tab sequence 

wndclass.cbClsExtra = 0; 
wndclass.hlnstance = hlnstance; 

return TRUE; 

wndclass.hlcon = LoadIcon(NULL, 

case WM COMMAND: 

IDI_APPLICATION) ; 

wndclass.hCursor = LoadCursor(NULL, 

switch (wParam) ( 

IDC ARROW); 

case 102: 

wndclass.hbrBackground = (HBRUSH) 

MessageBox 

GetStockObject(WHITE BRUSH); 

(hwnd, (LPSTR)vertptrl->GetLabel (), 

wndclass.lpszMenuName = NULL; 

(LPSTR)"Button Activated.", MB OK); 

wndclass.lpszClassName = szAppName; 

RegisterClass(&wndclass) ; 

vertptrl->Focus() ; 
return TRUE; 

1 

hwnd = CreateWindow(szAppName, 

case 103: 

"Vertical Button Demo", 

reply = MessageBox(hwnd, 

WS OVERLAPPEDWINDOW, 

(LPSTR)"Button Activated.\nYes changes button 1", 

CW USEDEFAULT, 

(LPSTR)vertptr2->GetLabel () ,MB YESN0) ; 

CW USEDEFAULT, 

if (reply == IDYES) 

CW USEDEFAULT, 

CW USEDEFAULT, 

vertptrl->SetLabel("&New Vertical 1 " .TRUE) ; 

NULL, 

vertptr2->Focus(); 

NULL, 

return TRUE; 

hlnstance. 

) 

NULL); 

) 

ShowWindow(hwnd,nCmdShow); 

return DefWindowProc(hwnd,message,wParam,1Param); 

UpdateWindow(hwnd); 

} 

} • 

while(GetMessage((LPMSG)&msg,NULL,0,0)) { 
if (!IsWindow(hwnd) | | 

(!IsDialogMessage(hwnd,&msg))) ( 

// End of File 
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There are two problems with this. First, it implies that the 
intercepting function must apply to the window class in the 
Windows sense of a registered window class, which is not a 
class in the C++ sense (it would be helpful if we could avoid 
using the same words in more than one sense, but...). While 
class subclassing is supported in the Windows API, it is 
dangerous and definitely not recommended, so the subclass¬ 
ing shown here is the subclassing of a specific window. 
Second, the definition implies that the intercepting function 
must do its processing before passing unwanted actions to 
the window procedure. The user window function will get 
control first, but, as shown in cc_DoVertProc() in Listing 4, 
the trick to customizing a standard button is to let Windows 
process the button first In this case, a C++ class member func¬ 
tion ( cc_DoVertProc()) is called by the window subclassing 
procedure (cc_VertProc()). 

Windows Functions and C++ Class Functions 

The member function Start () (see Listing 4) performs the 
actual subclassing. While this function consists of only six 
lines, it is the heart of the subclassing technique. First, it tells 
Windows to make an instance of the subclassing procedure 
(i cc_VertProc()) if one has not been made previously. Calling 
MakeProcInstance() for every instance of a control will quick¬ 


Listing 2 vbutclas.h 


/* Listing 2 

Windows vertical button class for C++ 
by Norman L. Hills & Davin S. Hills 
Copyright (c) 1992 Hills Object Technology, Inc. 

All Rights Reserved 

*/ 

//. 

// VButton Class 

//. 

class VButton { 
private: 

LPSTR lpText, ampindex; 

char tstr[80]; 

char winstr[3]; 

HWND curwnd, hwnde; 

HINSTANCE hlnst; 

BOOL state; 

int ilen, olen, wd, ht, charht, charwd; 

int hfoc, vfoc, WinX, WinY; 

RECT wrect; 

static WNDPROC lpfnOldVertProc; 

void DoVText(HDC.LPRECT); 
i nt SetupButton(LPSTR,BOOL); 

public: 

VButton(HWND,HINSTANCE,int,LPSTR,int,int,int, int); 
virtual LRESULT cc_DoVertProc(HWND,UINT,WPARAM,LPARAM); 
void Start(void); 

LPSTR Get Label(void); 

void SetLabel(LPSTR, BOOL = TRUE); 

void Focus(void); 

~VButton(); 

); 

typedef VButton +CCVPTR; 

/* End of File */ 


ly cause problems; checking for this case is the reason that 
lpfnOldVertProc() is static. Note that cc_VertProc() is an 
exported Windows WNDPROC procedure recognized by Win¬ 
dows as valid for processing a window and hence capable of 
replacing the default processing procedure. 

SetCObjptr() (see Listing 3) is the key to tying a C++ class 
to Windows; this function stores this (pointing to the in¬ 
stance of the C++ object) in the property list of the window. 
This makes the pointer available to any function that has the 
hwnd handle available —cc_VertProc() in particular. Accord¬ 
ing to Microsoft, “A property list is a storage area that contains 
handles for data that the application wishes to associate with 
a window. . . . Every window has its own property list." 
(Microsoft Windows Programmer's Reference, Section 1.17.) 

Just what we wanted! The conditional compilation instruc¬ 
tions are for Borland C++ and set the property list based on 
the size of an object pointer as determined by the memory 
model being compiled. The three functions handling the 
property list are shown in Listing 3. Since these functions work 
directly with Windows, they are not class member functions. 
The details are a bit tricky, but essentially they allow saving, 
retrieving, and deleting the this pointer of a C++ object in the 
property list of the window associated with the C++ object. If 
a complete set of C++ classes for all kinds of controls were 
available, these functions could apply to the base class and be 
used by all control classes. 

Continuing with the Start () function (in Listing 4), a 
pointer to the old window procedure is returned by the Sub- 
ClassWindowf) function. This function, a redefinition of a 
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SetUindowLongO Windows function for the GUL_UNDPROC 
index, is the statement which actually tells Windows to 
replace the processing function. The control is then invalidated 
to force a WM_PAINT message to be sent to the newly in¬ 
stalled window processing function —cc_VertProc(). 

cc_VertProc() can now retrieve this from the window 
property list and —at last —call a C++- class member function! 

Creating the Control 

The constructor for the VButton class initializes class vari¬ 
ables and determines the pixel size of a large character in a 
button label. Note that the X and Y (upper-left corner) location 
of the button is specified in dialog base units, as are the width 
and height. The defaults for width and height (specified in the 
parameter list of cc_VertButton()) are 0; in this case, the 
constructor will determine the size of the button. These may 
be overridden, but only with values larger than the calculated 
size. 

SetupButton() determines whether the button label con¬ 
tains an Alt-key for keyboard activation of the button. These 
are specified with a preceding ampersand and are displayed 
as underlined, winstr isolates this character to prevent a sec¬ 
tion of the full label from being displayed across the middle of 
the button. If the setsize parameter is TRUE, SetupButtonf) 
also calculates the default size of the button and part of the 
location of the focus rectangle. After checking for overrides of 
the button size, the wrect focus rectangle is set and the ini¬ 
tial state of the button is set to 0. If the X location was not -1, 
the control is then created with winstr as the window text. 
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Dialog Editors and Predefined Buttons 

The -1 defaults for location specified in cc_VertButton() 
allow use of the class functions in a special case. Most Win¬ 
dows programmers design dialog boxes with a visual resource 
editor, such as the Whitewater Resource Toolkit or the Bor¬ 
land Resource Workshop. Vertical buttons may be incor¬ 
porated in the design and tied to the class with the -1 option. 
Simply include a standard button in the design with the 
desired location and size, but do not specify a label. The label 
is given in the VButton constructor, but not in the dialog 
editor. Be sure that the dialog editor does not specify the but¬ 
ton as OUNERDRAU and that the size is large enough. The con¬ 
structor gets the button specification from Windows and ini¬ 
tializes the class object, ignoring the Y and size parameters 
passed to the constructor. The window is not created, since it 


Listing 3 property.cpp 


/* Listing 3 

Windows subclassing for C++ 
by Norman L. Hills & Davin S. Hills 
Copyright (c) 1992 Hills Object Technology, Inc. 

All Rights Reserved 

*/ 

lindude <dos.h> 

LPSTR FWOFF; 

LPSTR FWWSEG; 

/* Save "this" for VButton object 
in button Window's Property List 

*/ 

void SetCObjptr(HWND hwnd.CCVPTR ctlptr) { 

#if defined(_SMALL_) || (_MEDIUM_) 

FWOFF = (LPSTR)MAKEINTATOM(AddAtom("winoff")); 
SetProp(hwnd,FWOFF,(HANDLE)ctlptr); 
lelse 

FWOFF = (LPSTR)MAKE1NTATOM(AddAtom("winoff")); 

FWWSEG - (LPSTR)MAKEINTATOM(AddAtom("winseg")); 
SetProp(hwnd,FWWSEG,(HANDLE) FP_SEG (ctlptr)); 
SetProp(hwnd,FWOFF,(HANDLE) FP_OFF (ctlptr)); 
lendif 
} 

/* Retrieve "this" for VButton object 
from button Window's Property List 

*/ 

CCVPTR GetCObjptr(HWND hwnd) { 

#if defined(_SMALL_) || (_MEDIUM_) 

return (CCVPTR) GetProp(hwnd,FWOFF); 
lelse 

return (CCVPTR) (((long)(int)GetProp(hwnd,FWWSEG)«16) | 
(long)(int)Get- 

Prop(hwnd, FWOFF)); 
lendif 
} 

/* Clear “this" from Property List 
*/ 

void RemoveCObjptr(HWNO hwnd) { 

lif defined(_SMALL_) || (_MEDIUM_) 

RemoveProp(hwnd,FWOFF); 
lelse 

RemoveProp(hwnd,FWWSEG); 

RemoveProp(hwnd,FWOFF); 
lendif 
} 

// End of File 
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already exists, but the possible Alt-key combination is set 
with SetUindowText(). Thereafter, the button may be treated 
exactly as though it had been created. 

The key to establishing this type of VButton is the Win¬ 
dows control ID —this is the only way to find the window in 
the dialog resource. You must therefore make absolutely sure 
that the button is in the resource file. If VButton cannot find 
the button, your program will almost certainly crashl The test 
program does not include a dialog or a resource file to 
demonstrate this option, but the dialog procedure will be 
much the same as UndProc(), with the pointer initialization in 
the UM INITDIALOG case. 


Displaying the Control 

The reason for subclassing the button procedure in the first 
place is to allow Windows to do most of the work while the 


Listing 4 vbutton.cpp 


/* Listing 4 

Windows vertical button member functions for C++ 
by Norman L. Hills & Davin S. Hills 
Copyright (c) 1992 Hills Object Technology, Inc. 
All Rights Reserved 


*/ 


lifndef SubclassWindow 

Idefine SubclassWindow(hwnd, lpfn) \ 

((WNDPROC)SetWindowLong((hwnd), \ 

GWL_WNDPROC, (LPARAM)(WNDPROC)(lpfn))) 

lendif 


/* Instantiate a VButton object 
*/ 

CCVPTR cc_VertButton(HWND hwnd, HINSTANCE hlnst, 
int winID, LPSTR lptext, 
int X = -1, int Y * -1, 
int width = 0, int height = 0) { 

CCVPTR vertptr; 

vertptr = new VButton(hwnd, hlnst, winID, lptext, 
X, Y, width, height); 

vertptr->Start(); 
return vertptr; 

) 

/* Windows Function that can access a VButton class 
member function via the Property List 

*/ 

LRESULT CALLBACK _export cc_VertProc(HWND shwnd, 

UINT msg, 

WPARAM wP, 

LPARAM IP) ( 

CCVPTR vptr; 

vptr ■ (CCVPTR)GetCObjptr(shwnd); 
if (vptr) 

return vptr->cc_DoVertProc(shwnd,msg,wP,lP); 
return DefWindowProc(shwnd,msg,wP,lP); 


int VButton::SetupButton(LPSTR lpsettext, 

BOOL setsize) ( 

lpText = (LPSTR)Ststr; 
lstrcpy(lpText,lpsettext); 
ilen = lstrlen(lpText); 
ampindex = NULL; 

for (lpText; *lpText; lpText++) { 

if (*lpText == 38) { // & 

ampindex = lpText; 
winstr[l] ■ *++lpText; 
break; 


new procedure does the customization. The cc_DoVertProc() 
member function handles these chores. As mentioned earlier, 
this procedure calls the original Windows procedure first and 
then draws the vertical text on the button. If the original pro¬ 
cedure were called afterwards, the newly written modifica¬ 
tions would be erased by Windows. The button is not 
specified as OWNERDRAU because this would defeat much of 
the purpose for subclassing: since Windows handles none of 
the drawing for such buttons, cc_DoVertProc() would need 
to draw the button edges and determine all of the various 
states. Without these responsibilities, the procedure is quite 
simple. A state variable is maintained, and the button is 
repainted only when the state changes in response to the 
user. Windows will keep track of this state for the display, but 
there will be annoying flicker from every mouse move if this 
check is not made. Other than state changes, only the 


) 

) 

lpText = (LPSTR)&tstr; 

if (setsize) { 

wd ■ charwd + 16; 
ht = (charht * ilen) + 16; 
if (ampindex) 
ht -= charht; 
hfoc ■ 6; 
vfoc « 0; 

) 
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Listing 4 continued 


return (ilen); 

if (UpfnOldVertProc) 

} 

MakeProcInstance((FARPROC)cc VertProc,hlnst) ; 

/* Constructor 

SetCObjptr(hwnde,(CCVPTR)this) ; 

*/ 

lpfnOldVertProc = SubclassWindow(hwnde,cc VertProc); 

VButton::VButton(HWND hwnd, HINSTANCE hlnstance. 

GetWindowRect(curwnd,(LPRECT)&trect) ; 

int winID, LPSTR lptext, 

InvalidateRect(curwnd,(LPRECT)&trect,TRUE) ; 

int X, int Y, 

} 

int width, int height) { 


DWORD dsize; 

void VButton::DoVText(HDC vhdc.LPRECT irect) { 

HDC aDC; 

HBRUSH hbrush; 

int xunits, yunits; 

HPEN hpen; 

curwnd ■ hwndj 

RECT vrect; 

hlnst = hlnstance; 

LPSTR lpvtext; 

aDC ■ GetDC(hwnd); 

COLORREF otc, obc; 

dsize = GetTextExtent(aDC,“W",l) ; 

CopyRect(&vrect,irect) ; 

ReleaseDC(hwnd.aDC) ; 

hbrush = CreateSolidBrush 

charwd = LOWORD(dsize) ; 

(GetSysColor(COLOR BTNFACE)) ; 

charht = HIWORD(dsize) ; 

hpen = CreatePen(PS SOLID,1, 

winstr[0] = 38; 

GetSysColor(COLOR BTNFACE)); 

winstr[l] = 1 \0 1 ; 

SelectObject(vhdc,hbrush) ; 

winstr[2] - 1 \0 1 ; 

SelectObject(vhdc.hpen) ; 

tstr[0] « 1 \0 '; 

Rectangle(vhdc,vrect.left,vrect.top,vrect.right. 

xunits * LOWORD(GetDialogBaseUnitsO) ; 

vrect.bottom) ; 

yunits = HIWORD(GetDialogBaseUnitsO) ; 

SelectObject(vhdc.GetStockObject(WHITE BRUSH) ) ; 

if (X == -1) { 

SelectObject(vhdc,GetStockObject(BLACK_PEN)) ; 
DeleteObject(hbrush) ; 

hwnde = GetDlgltem(hwnd,winID) ; 

DeleteObject(hpen) ; 

GetWindowRect(hwnde,(LPRECT)&wrect) ; 

obc = SetBkColor(vhdc,GetSysColor(COLOR BTNFACE)); 

ScreenToClient(hwnd, 

otc * SetTextColor(vhdc, 

(LPPOINT)&wrect.left) ; 

GetSysColor(COLOR BTNTEXT)) ; 

ScreenToClient(hwnd. 

vrect.top +■ vfoc + 1; 

(LPPOINT)&wrect.right); 

vrect.bottom « vrect.top + charht; 

width » wrect.right - wrect.left; 

for (lpvtext ■ lpText; *lpvtext; lpvtext++) ( 

height ■ wrect.bottom - wrect.top; 

if (lpvtext != ampindex) 

// size is adjusted, therefore... 

:: DrawText ( vhdc, 1 pvtext,1,&vrect, 

xunits = 4; yunits = 8; 

(DT CENTER | DT VCENTER | DT SINGLELINE)); 

WinX = wrect.left; 

el se ( 

WinY = wrect.top; 

:: DrawText ( vhdc, 1 pvtext,2,&vrect, 

} 

(DT CENTER | DT VCENTER | DT SINGLELINE)); 

el se { 

lpvtext++; // bump an extra 

WinX * (X * xunits) / 4; 

) 

WinY = (Y * yunits) / 8; 

vrect.top = vrect.bottom; 

} 

vrect.bottom += charht; 

olen = SetupButton(lptext.TRUE) ; 

) 

width = (width * xunits) / 4; 

SetBkColor(vhdc.obc) ; 

if ((width > wd) || (X *■ -1)) { 

SetTextColor(vhdc.otc) ; 

wd = width; 

1 

hfoc = ((width - charwd) / 2) - 3; 

/* The subclassed Windows "WNDPROC" 

*/ 

LRESULT VButton::cc DoVertProc(HWND dhwnd, UINT msg, 

/ 

height = (height * yunits) / 8; 

if ((height > ht) || (X == -1)) 

WPARAM wP, LPARAM IP) { 

ht = height; 

HDC shdc; 

SetRect((LPRECT)&wrect,WinX+hfoc,WinY+vfoc+6, 

RECT prect; 

WinX+wd-hfoc,WinY+ht-vfoc-6); 

LRESULT retval; 

state * 0; 


if (X != -1) 

retval = CallWindowProc((WNDPROC)lpfnOldVertProc, 
dhwnd,msg,wP,1P); 

//. 

if ((msg == WM SETFOCUS) || (msg == WM PAINT)) ( 

hwnde = CreateWindow(”button", (LPSTR)&winstr, 


(WS CHILD | WS VISIBLE | 

shdc = GetDC(GetParent(dhwnd)); 

WS TABSTOP I BS PUSHBUTTON), 

CopyRect((LPRECT)&prect,(LPRECT)&wrect); 

WinX,WinY,wd,ht,hwnd,(HMENU)winlD, 

if (state) 

hlnstance,NULL); 

OffsetRect((LPRECT)&prect,1,2); 

//. 

DoVText(shdc,(LPRECT)&prect); 

else // activate possible Alt-key 

if (hwnde *■ ::GetFocus()) 

SetWindowText(hwnde,(LPSTR)&winstr); 

DrawFocusRect(shdc,(LPRECT)&prect); 

} 

ReleaseDC(GetParent(dhwnd),shdc); 

/* Start the VButton 

return TRUE; 

} 

*/ 

if (msg == BM SETSTATE) { 

void VButton::Start(void) ( RECT trect; 
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WM_SETFOCUS and WM_PAINT messages are processed. There is 
no need to process the WM_COMMAND or button-down mes¬ 
sages — by calling the Windows procedure first, the parent 
window is automatically notified when the VButton is ac¬ 
tivated. It's essential that the value returned by the default 
Windows procedure be saved and returned for any messages 
not processed by cc_DoVertProc()\ you might try simply 
returning TRUE as an exercise to see what happensl 

If the state is depressed, the text location rectangle is of¬ 
fset right and down. If the button also has the input focus, the 
focus rectangle is drawn. The DoVText () function actually dis¬ 
plays the button label. This is written as a separate function 
to clarify the actions taken in cc_DoVertProc(), but it should 
be incorporated directly inline to avoid a function call. Specify¬ 
ing DoVText () as an inline function won't help since DoVText 
contains a for loop and wouldn’t actually be compiled inline 
by most C++ compilers. DoVText () treats the rectangle on the 
face of the button as simply a surface for GDI graphics func¬ 
tions. The window text put on the surface of the button by 
Windows (the winstr Alt-key) is first cleared with a Rec¬ 
tangle function. Then the characters from the label string are 
drawn down the face of the button. The only complication is 
the Alt-key letter. Fortunately, DrauText() recognizes the 
ampersand if the string is two bytes long and does the under¬ 
lining automatically. The only other point to note is the choice 
of a device context for the GDI functions. The GetDCf) API 
function is called for the parent of the button — not for the 


Listing 4 continued 


if ((!wP && Istate) || (wP && state)) 

return FALSE; // Stops the flicker! 
state * wP; 

SendMessage(dhwnd,WM_PAINT,0,OL); 
return TRUE; 

) 

return retval; // MUST save from call & use 

) 

/* Auxiliary class functions 
*/ 

void VButton::SetLabel(LPSTR lpnewtext.BOOL resize) { 
RECT trect; 

if ((lstrlen(lpnewtext) <= olen) || (resize)) ( 
SetupButton(lpnewtext, resize); 
if (resize) ( 

MoveWindow(hwnde, Wi nX, Wi nY, wd, ht,TRUE); 
olen = ilen; 

} 

SetWindowText(hwnde,(LPSTR)&winstr); 
SetRect((LPRECT)iwrect,WinX+hfoc,WinY+vfoc+6, 
WinX+wd-hfoc, WinY+ht-vfoc-6); 
GetWindowRect(curwnd,(LPRECT)Street); 

Inval idateRect(curwnd,(LPRECT)Street,TRUE); 

1 

} 

LPSTR VButton::GetLabel(void) ( 

return (LPSTR)1pText; ) 

void VButton::Focus(void) ( ::SetFocus(hwnde); ) 

VButton::~VButton() ( RemoveCObjptr(hwnde); ) 

WNDPROC VButton::lpfn01dVertProc; 

// End of File 
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button itself, because the rectangle for the button surface was 
defined relative to the parent window. 

Device Independence 

The location and size of the VButton are given in dialog 
base units because these are the numbers used in dialog 
resource editors and because of the increasing use of so- 
called large font video drivers. Recent high-speed and high- 
resolution video cards and the related drivers have led many 
users to run Windows in 800x600 or even 1024x768 video 
mode. One problem with this is that the text in menus or on 
buttons is correspondingly small. Many video drivers, such as 
the ATI Ultra, allow using basically 640x480 resolution text for 
these elements, while retaining the higher resolution for the 
graphic elements. In this case, the dialog base units no longer 
translate to a simple factor of 2. When buttons are located 
and sized in a dialog editor, they are automatically adjusted 
for this difference, but creating a control directly in a construc¬ 
tor in other than dialog units would not account for this pos¬ 
sibility. Thus for an editor-defined VButton, xunits and yunits 
are set so that no adjustment takes place, since Windows will 
have made the adjustment in the numbers returned by the 
GetUindowRectf) function. 

One refinement in DoVText() is that the colors chosen for 
the GDI functions are retrieved from Windows each time the 
function is executed. It might seem easier to get and save 
these in the constructor to avoid the function calls in 
DoVText(), but if this were done, the buttons would not 


change color in response to system-wide color changes made 
while the program with the VButtons was active. 

Auxiliary Functions 

The remaining class functions at the end of Listing 4 are 
only some of the possibilities for class member functions. Set- 
Label () checks the length of the new label against the 
original length returned from SetupButton() — you may 
change the size of the button for the new text, but the resize 
parameter ensures that you at least know that this is going to 
happen. As demonstrated in the test program, the Alt-key 
combination may also be changed for the new label. 

Summary 

You may never need a button with vertical text, but at 
some point most Windows programmers would like to have 
some sort of custom button. The technique discussed here 
can be used to paint anything on the face of any button that 
is still basically handled by Windows. The real power of C++, 
however, comes only when control classes of various types 
are arranged in a logical hierarchy. Then, many of the func¬ 
tions and features can be inherited, which can dramatically 
reduce the overhead required for any one type of control. 
Likewise, most of the messiness involved in WinMain(), Und- 
Proc(), and dialog procedures can be relegated to C++ classes 
— the resulting Windows program can be a joy to write, and 
not simply a programming chore! □ 
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The Case of the Deadly APPEND Command 


Tony Ingenoso 
1323 S.E. 17th #274 
Ft. Lauderdale, FL 33316 


Starting with DOS 4.0, the APPEND command added a new “feature” which can 
have grim implications for TSRs and programs using DOS’s swappable data areas: this 
was Int 2F function B7 subfunction 11. 

What this function does is alter the behavior of the next Int 21 function 3D, 43, 
or 6C call that occurs. The new behavior causes the file name string passed into 
these calls to be overwritten with a fully qualified path/filename. 

APPEND doesn't seem to be too careful about trying to avoid the danger either. 
The altered behavior happens even if an intervening Set PSP call is made (which 
any TSR dealing with files will have to do). 

The implications for programs not equipped to deal with having their data areas 
being overwritten are serious. Consider the scenario: 

1. An application makes the Int 2F function B7 subfunction 11 call. 

2. Now, a TSR activates before the app gets to do the subsequent call to 3D, 43, or 6C. 

3. The TSR will trigger the altered behavior if it makes a call to 3D, 43, or 6C. 

Will this TSR be prepared to have its data areas overwritten? I suspect not. Will 
the application be happy that when it gets control again, it doesn't get its fully 
qualified path on its next 3D, 43, or 6C call? Again, I suspect not. 

An obvious defense for newly written TSRs and such is to always allow for a 
maximum path length string when they make a call to 3D, 43, or 6C, and to not rely 
on the contents of that buffer to remain intact after the call. 



Leor Zolman wrote BDS C, the first C compiler targeted exclusively for personal com¬ 
puters. Leor is currently an instructor on UNIX topics for Boston University’s Corporate 
Education Center, a regular contributor to The C Users Journal and Sys Admin 
magazines, and 'Tech Tips” editor for Windows/DOS Developer’s Journal. His first book, 
Illustrated C, was recently published by R6cD Publications, Inc. He may be contacted at 
74 Marblehead St., North Reading, MA 01864, or on Usenet/Internet as-. 
leor@bdsoftcom. 
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Listing 1 techtip.c 

/* 


* Demonstration of DOS "append" bug 
*/ 


#i fndef _TURB0C_ 

#error This program needs Turbo-C! 
lendif 


linclude <stdio.h> 
linclude <process.h> 
linclude <io.h> 
linclude <dir.h> 
linclude <dos.h> 


Idefine CARRY (_FLAGS & 1) 


static char near CurAppendPath[150] * (0); 

static char near Work[150] * {0}; 

static char near DangerDanger[100] * "XXXXXXXX.XXX" 

static char near RestoreAppend = 0; 

1 

static void fatal(char *msg) 


l 

if (RestoreAppend) 


system(CurAppendPath); 


printf(“*** ERROR *** [%s]\n“, msg); 
exit(l); 

} 


void main(void) 

( 

char far *AppendPath; 


char far *p; 
int handle; 


printf("+- 

-+\n" 

"1 The case of the deadly APPEND command l\n" 

”+. 

-+\n“ 

“| Tony Ingenoso, 1992 

|\n" 

■t. 

—-+\n"); 

/*. 


Check for DOS 4.0+ 

—*/ 

AX = 0x3000; 


geninterrupt(0x21) ; 
if ( AL < 4) 


fatal("I Need DOS 4.0 or better for 

this demo."); 

/* . 


Check for APPEND 

—*/ 

AX = 0xB700; 


geninterrupt(0x2F) ; 


if ( AL 1* OxFF) 


fatal ("APPEND isn't loaded."); 


/* . 


Get APPEND'S current path 


Int 2F fn B7 subfn 04 returns pointer in ES:DI 


—*/ 

AX = 0xB704; 


geninterrupt(0x2F) ; 


AppendPath = MK_FP(_ES,_DI) ; 


/* . 

Save APPEND's current path in a form that we 

can 

restore with a call to systemO later. 

—*/ 

for (p = Work; ‘AppendPath;) 
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This tactic doesn't solve the problem 
of the application that made the Int 
2F call: it still cannot get its fully 
qualified path when control is returned. 

I can’t think of any sure way to 
resolve this once a TSR has made a 3D, 


43, or 6C call. The TSR doesn't know 
what kind of Int 21 filters have al¬ 
ready been installed, so even if it did 
some bookkeeping and •‘re-armed” the 
function before exiting, it could be setting 


Listing 1 continued 


*p++ = *AppendPath++; 

*p ■ '\0'; 

sprintf(CurAppendPath, "APPEND %s", Work); 


/*.-. 

Hake a temporary directory with a file named 
XXXXXXXX.XXX in it. 


if 


*/ 


(mkdir(“_TEMP.DIR")) 

fatal("I couldn't make temp directory"); 


if ((handle = _creat("_TEMP.DIR\\XXXXXXXX.XXX", 0)) == -1) 
fatal("I couldn't create temp file"); 


close(handle); 


/* 


Aim APPEND at the temp directory we just made. 

.*/ 


if (systemC'APPEND _TEMP.DIR")) 

fatal("Couldn't exec APPEND"); 
RestoreAppend * 1; 


/*. 

At this point we've saved the old APPEND path 
and have set a new one to a temp directory we 
just created. We're now in position to try a 
file open operation on the temp file in the 
temp directory that only APPEND knows about. 

At this point we are going to 'arm' APPEND to 
♦OVERWRITE* the filename string on the NEXT 
Int 21 call. 

. */ 

printfC'The initial name string = [%s]\n", DangerDanger); 

_AX = 0xB711; /* Arm the APPEND weapon */ 

geninterrupt(0x2F); /* This is it...it's set to go off! */ 

_BX = _psp; /* An activating TSR would do */ 

_AX = 0x5000; /* something like this... */ 

geninterrupt(0x21); 

#pragma warn -apt 

_DX = (void near *)(void far *)&DangerDanger[0]; 

Ipragma warn .apt 
_CX = 0; 

_AX = 0x3D00; /* Open the file */ 

geninterrupt(0x21); /* BANG!, This should trigger it. */ 

if (CARRY) 

fatal("Couldn't open file"); 

_close(_AX); 

printfC'The overwritten string = [%s]\n", DangerDanger); 


/*. 

Cleanup and restore original APPEND path. 

.*/ 

uni i nk ("_TEMP. DIRWXXXXXXXX. XXX"); 

rmdir(“_TEMP.DIR"); 

system(CurAppendPath); 

) 

/* End of File */ 
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Listing 2 c.bat 


@echo off 

rem C.BAT: Compile a program, and recall last explicit set of parameters 

rem if no filename is specified. Written by Leor Zolman, 11/92 

rem 

rem Usage: 

rem c [command line parameters] - save cmd line image 

rem c - re-issue saved image 

rem 

rem This script will work with any application; just substitute the 

rem the name of your compiler or application for "bcc" in the line below: 

set APP=bcc 

if "%1" !■= goto explicit 
if “%lastcmd" != "" goto run 

echo You have not specified a command yet; 
echo please enter an explicit command line! 
goto end 

:explicit 

set lastcmd=%APP %1 %2 %3 %4 %5 %6 %7 %8 %9 

echo Setting command line to "%lastcmd" and executing. . . 

goto run2 

:run 

echo Executing the command: %lastcmd. . . 

:run2 

%lastcmd 

:end 


Listing 3 shred.c 


/* 

* shred.c: Shred a file so it cannot be undeleted 

* Written by John N. Power - 16 Sep 92 

* Compiler: Microsoft C 5.1 / Borland C 3.1 
*/ 

linclude <stdio.h> 
linclude <stdlib.h> 
linclude <io.h> 
linclude <memory.h> 
linclude <ctype.h> 

main(int argc, char **argv) 

{ 

FILE *shredfile; /* file to be shredded */ 

long filelen; /* its length */ 

char buf[512]; 
int i, numbufs; 

if (argc != 2) /* check for single arg */ 

( 

putsC'usage: shred shredfile"); 
exit(l); 

) 

printf("Do you really want to shred file: %s (Y/N)? ", argv[l]); 
if (tolower(getchar()) != 'y 1 ) 

{ 

puts("Not shredding."); 
exit(l); 

} 

if ((shredfile « fopen(argv[l], "rb+")) == NULL) 


up someone else to get clobbered 
down the line. 

An avoidance approach is for the 
TSR to filter Int 2F calls and Int 21 
functions 3D, 43, and 6C. When the Int 
2F call is made, set a flag. When any 
Int 21 3D, 43, or 6C call is made, clear 
the flag. If asked to activate when this 
flag is set, the TSR would refuse. 

I guess the world just became a lit¬ 
tle more dangerous place to live ... 

The small C program in Listing 1 
demonstrates this particular gotcha in 
action. It should be compiled with 
Turbo/Borland C. Any standard memory 
model will work. For example: fee -w 
techtip.c 



Quick and Dirty Command 
Line Replication 


Leor Zolman 
74 Marblehead St. 
North Reading, MA 01864 


When compiling and testing C ap¬ 
plications, I’m often developing small fil¬ 
ters or utilities that really don't need a 
full-blown make file associated with 
them. Nevertheless, retyping a compiler 
command line, even with only a few 
command-line options, gets tedious 
after enough repetitions. If I'm always 
entering the same options on those 
command lines, why not let the com¬ 
puter retype them for me upon demand? 

The batch file C.BAT (Listing 2), if 
called with any non-null list of 
parameters, calls up the bcc (Borland Q 
compiler with parameters exactly as 
specified by the given parameters. Also, 
an image of the bcc command line is 
saved in an environment variable 
named LASTCMD. 

When C.BAT is invoked with no 
parameters, then the command line 
saved in the LASTCMD environment vari¬ 
able is submitted for execution. 

For example, if you first compile a C 
program with 


c -v program.c wildargs.obj 

then you can repeat the same compila¬ 
tion command by simply typing 


c 


Page 60 - Windows/DOS Developer’s Journal 


January 1993 























I’ve generalized this script to work for 
any command. Just substitute the name 
of any desired application in the in¬ 
itialization of the APP variable at the top 
of the script, and you have a quick 
shorthand for recalling the last explicit 
command. The “dirty” part, by the way, 
comes from having to implement this 
with standard MS-DOS batch file com¬ 
mands for portability; my NDOS version 
is the “clean” one. 

A Simple File Shredder 


John N. Power 
Power Technologies 
Suite 110-387, 4132 Joppa 
Road 

Baltimore, MD 21236 

The tip by Philip Erdelsky in your 
September issue reminded me of a 
CP/M file shredder I wrote some years 
ago. The code (Listing 3), adapted for 
the PC, is similar to Mr. Erdelsky's. It 
may be more convenient to use since it 
does not create a new file, and faster because it does not 



Listing 3 continued 

( 

printf(“Unable to open file: Vs\n", argv[lj); 
exit(l); 

) 


filelen - fiTelength(fi 1 eno(shredf i1 e)); 

if (filelen «■ -1L) /* -1 means file length */ 

{ /* determination failed */ 

puts("0peration failed."); 
fclose(shredfile); 
exit(l); 

) 


numbufs - (int) (fi 1 elen/512L); /* no. of buffers needed 
if ( (int) (filelen V 512L)) /* to cover the file 

numbufs++; 

*/ 

*/ 

memset(buf, 'NO 1 , 512); /* fill the file with nulls 

*1 

for (i » 0; i < numbufs; i++) 

fwrite(buf, 1, 512, shredfile); /* overwriting now 

fclose(shredfile); 
unlink(argv[lj); 
puts("0peration complete."); 
return 0; 

) 

/* End of File */ 

*/ 


process the entire disk. 

For added security, you can rename the target file to a 
meaningless string just before the unlinkQ step. This will 
remove the original file name from the directory. 


Salvaging TSR Environment Space 


Norm Mosher 
34 Fuller Road 
Corinth, NY 12822 


Listing 4 autoexec.bat 


0ECHO OFF 
VERIFY ON 
PATH C: 

ON 

PATH C:\D0S;C:\BIN;C:\UTIL 
PROMPT $P$G 

SET INCLUDED:\INCLUDE 

SET LIB=C:\LIB 

SET 4DSHELL=/S:DD:\ 

SET SPACEl=Reserve for future SETs, etc. 

SET SPACE2=to avoid needing more ENV space 

ALIAS /R C:\D0S\ALIST.1 

C:\DOS\MOUSE 

SET SPACE1 

SET SPACEZ 

C:\D0S\NEWKEYVS /800 
C:\D0S\ENVRLS NEWKEYVS 
C:\D0S\H0TPMS C:\PCS.BIN 
SETDOS /H2 /U1 



SOFTWARE? AT INTEL? 



Intel’s commitment to driving technology for the PC 
products of the future has created opportunities for skilled 
software professionals. We have the tools, resources and 
technical leadership to make advances in computer supported 
collaboration a reality. Jump into the race with us by bringing 
your strong C/C++ development skills in a Windows*, 

DOS*, OS/2* or LAN environment, BSCS (MSCS preferred) 
and five years’ related project development experience in the 
following areas. 

MULTIMEDIA TECHNOLOGY 
MOBILE COMPUTING 
HANDHELD & PEN-BASED COMPUTING 
PC SOFTWARE DRIVERS 
INTEGRATED MESSAGING TECHNOLOGY 
WIRELESS LANS 

There’s no place like Portland for great living. And no place 
like Intel for challenging work. Put the two together and it’s 
an opportunity you can’t pass up. Send or fax your resume 
today to: Intel Staffing, Dept. 0206, 5200 N.E. Elam Young 
Parkway, HF2-05, Hillsboro, OR 97124. FAX: (503) 696-2581. 

intel. 

•Windows and DOS are registered trademarks of Microsoft Corp. OS/2 is a registered trademark of IBM. Intel Corporation 
is an equal opportunity employer and fully supports affirmative action practices. Intel also supports a drug-free workplace and 
requires that all offers of employment be contingent on satisfactory pre-employment drug test results. 
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Just a fraction of the time we spend on the 
phone can help answer society’s problems. 



Just a fraction of our time watching movies 
could help bring many happy endings. 



Just a fraction of what we spend dining out 
can help pick up the tab for a worthy cause. 

It takes so little to help so much. 

Millions of people have helped establish five per¬ 
cent of their income and five hours of volunteer 
time per week as America’s standard of giving. 


Get involved with the causes you care about 
and give five. 



Listing 5 

envrls.asm 



EnvRls 

— Environment Release 



Written by Norm Mosher 




Assemble and 

link (Turbo Assembler): 


tasm envrls 




11 ink 

/1 envrls 



bs 

segment 





org 

0 

• 

DOS Memory-Control-Block layout 

MCBtype 

db 

? 

• 

Type = 1 M 1 if non-last 

MCB PID 

dw 

? 

> 

Program-Segment-Prefix segment addr. 

MCBsize 

dw 

? 

• 

No. of Paragraphs this block 



org 

0 



PSPmark 

dw 

? 

l 

contains 'INT 20h 1 instruction 



org 

2ch 



PSP ENV 

dw 

? 

» 

Environment segment addr. 



org 

82 h 

t 

"Conmand Tail" specifies 

ComTail 

db 

? 

• 

name of target program 



org 

256 

• 

10-byte storage area: 

MyPID 

dw 

? 

• 

My own PSP seg. 

WkMCB 

dw 

? 

• 

and temporary storage 

WkSeg 

dw 

? 

* 

for internal use 

WkSiz 

dw 

? 



WkPtr 

dw 

? 





assume cs:bs,ds:bs,es:bs,ss:bs 



org 

256 



start: 

mov 

si.offset 

ComTail ; 

Set addr. pointer and count 



mov 

cx,9 

> 

for input scan and case-convert 



mov 

bx,offset 

WkVal+1 ; 

Set store-value address, too 



cld 




initl: 

lodsb 

• 

Get input characcter 



cmp 

al, ' ' 

; 

If space or lower, 



jna 

init2 

> 

scan is finished 



cmp 

al.'a' 

> 

Is it lower-case alpha? 



jc 

initla 

; 

No: go on around 



sub 

al.'a'-'A 

» 

Yes: make it upper-case 

initla: 

mov 

[bx],al 

» 

Store character in Work-Value, 



inc 

bx 

* 

and point to next char, slot 



loop initl 

> 

Check next character 

errorl: 

mov 

ax,4c01h 

» 

If too many characters, return 



int 

2 lh 

• 

with ERRORLEVEL * 1 

ini t2 

sub 

si.offset 

ComTail-l ; 

Compute no. of bytes to check 



cmp 

si,3 

• 

If nothing between "\" and 



jc 

errorl 

• 

it's no good 



mov 

WkPtr,bx 

• 

Save RHE addr. of saved value 



mov 

WkSiz,si 

• 

Save length of saved value 



mov 

ah,52h 

» 

Use Dos function 52h to find 



int 

2 lh 

I 

"List-of lists" addr., and get 



mov 

es.es:[bx-2] ; 

first-MCB segment addr. in ES 



mov 

MyPID,cs 


Save my own PSP segment addr. 

loopl: 

mov 

ax,es 

; 

Save segment addr. of MCB, and 



mov 

WkMCB,ax 

» 

of next paragraph, which is 



inc 

ax 

» 

the beginning of the 



mov 

WkSeg,ax 

• 

memory area itself 



cmp 

ax,es:MCB 

pid ; 

Is this MCB for a PSP? 



jnz 

loopla 

• 

If not, don't bother with it; 



cal 1 

chkl 

: 

if so, go see if it's the target 
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Most TSR programs do not need 
their “environment" memory space 
after they have issued their call to "ter¬ 
minate and stay resident.” However, 
DOS does not make this assumption, 
since it is legal for a program to use its 
environment area even after this point. 
If you write TSR routines that do not 
specifically need this area after the TSR 
function call, you can release the un¬ 
used block of memory by use of DOS 
function 49h, as follows: 


mov es,PSP_ENV ; Get environment-segment 
addr. from 

mov ah,49h ; word at 2Ch of PSP and ask 
DOS to 

int 21h ; release it 

This is especially important if you are 
executing a series of TSRs from your 
AUTOEXEC.BAT file, since it makes it pos¬ 
sible for each TSR in turn to reuse the 
same environment space released by 
those preceding it. Note, however, that 
the amount of environment space 
needed tends to increase with succes¬ 
sive program executions, not only be¬ 
cause of SET statements which may fol¬ 
low your TSRs, but also because later 
commands may have longer path 
names and/or command tails (e.g., 
parameter lists). Thus it may be 
worthwhile to waste some environment 
space in your TSR invocations in order 
to assure that they will set aside (and 
then release) enough environment 
space to meet the needs of later 
programs. This can be done by inserting 
one or more "dummy” SET commands 
before the first TSR invocation and then 
clearing the extra space afterward. An 
example of this is shown by the SET 
SPACE1... and SET SPACE2... state¬ 
ments in the enclosed AUTOEXEC.BAT 
example (Listing 4). 

Also shown in my AUTOEXEC.BAT ex¬ 
ample is my ENVRLS program, used here 
to release the environment allocated 
for NEUKEYVS. The NEUKEYVS TSR is a 
keyboard enhancer from FAB Software 
(Wayland, MA) which I have found to be 
virtually indispensable, but which does 
not release its environment before its 
Terminate-and-Stay-Resident call. I 
found that I could fool DOS into releas¬ 
ing the unneeded environment after 
the fact by writing a program that 
releases its own environment block and 


Listing 5 

continued 


loopla: 

jz 

gotcha 

i If it's the one, go release it! 


mov 

ax,es:MCBsize 

; Calculate segment addr. for 


add 

ax.WkSeg 

; next MCB 


cmp 

es:MCBtype, ' M' 

; See if this was non-last MCB, 


mov 

es.ax 

; and set ES to point to next one 


jz 

loopl 

; If not at end, go try next MCB 

> 

Note 

-- The following four lines of code are here just in case 

t 


the environment 

to be released belongs to a program loaded 

» 


into upper memory by the LOADHIGH command of Version 5.0 

• 


of MSDOS. This 

code should not cause any problems under 

» 


earlier DOS versions. 


cmp 

ax,9fffh 

; Are we at UMB boundary (DOS 5.0)? 


jnz 

errxit 

; If not, no more chances 


cmp 

es:MCBtype,'M' 

; If yes, are there UMB's to do? 


jz 

loopl 

; If so, go resume search 

errxit: 

mov 

ax,4c02h 

; Target not found, so return 


int 

21 h 

; with ERRORLEVEL - 2 

gotcha: 

mov 

WkSeg.bx 

; Save target environment segment 


dec 

bx 

; Deer, to convert to MCB segment 


mov 

es,bx 

; addr. in ES, and see if there 


cmp 

es:MCBtype,'M' 

; are any more MCBs following; 


jnz 

errxit 

; if not, don't bother to release! 


mov 

es.PSP ENV 

; OK, give my own environment 


mov 

ah,49h 

; memory back to DOS now 


int 

21 h 



jc 

errxit 

; (If no good, report failure) 


mov 

es,bx 

; Now make DOS think the target 


mov 

es:MCB PID.cs 

; environment is mine, so it will 


mov 

ax.WkSeg 

; be released when I terminate 


mov 

PSP ENV.ax 



mov 

ax,4c00h 

; Return with ERRORLEVEL * 0 


int 

21 h 

; to indicate successful release! 

WkVal 

db 

•\.’ 


chkl: 

push ds 



push ax 

; Save AX, which contains 


mov 

ds.ax 

; Segment-adr. of PSP 


cmp 

PSPmark,20cdh 

; If not really a PSP, 


jnz 

returnl 

; get back right now! 


mov 

bx.PSP ENV 

; Get segment-addr. of MCB 


dec 

bx 

; for this PSP's environment. 


mov 

ds.bx 

; and use DS to addr. MCB 


cmp 

ax.MCB PID 

; Is it this PSP's environment? 


jz 

chkla 

; If so, go check it some more! 

returnl: 

pop 

ax 

; Restore AX contents, and 


pop 

ds 



ret 


; get back to mainline 

chkla: 

mov 

cx.MCBsize 

; Convert MCB-size 


shl 

cx,l 

; (paragraph count) 


shl 

cx,l 

; to byte-count 


shl 

cx,l 

; for use as 


shl 

cx,l 

; loop-control counter 


mov 

si ,0 

; Set offset and 


inc 

bx 

; segment (DS:SI) to 


mov 

ds.bx 

; scan this environment block 
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Listing 5 continued 

chklb: lodsb 

Get a character, and 

or al.al 

see if it's a NULL 

loopnz Chklb 

If not, try next one 

jnz returnl 

(None found, no good!) 

emp al,[si] 

Is next character also NULL? 

jnz chklb 

No, loop to keep trying 

chklc: lodsb 

OK, now let's scan until we 

emp al, 1 . ‘ 

find a 1 . 1 within this 

loopnz chklc 

environment... 

jnz returnl 

(None found, no good!) 

push es 

Save caller's ES, then set 

push cs 

ES to my own Segment addr. 

pop es 


mov di,cs:WkPtr 

Use ES:DI to point to saved 

mov cx,cs:WkSiz 

value, with byte-count in CX 

dec si 

Back off SI to '.' we found 

std 

Now compare right-to-left 

repz empsb 

for intended value, and 

cld 

clear direction flag 

pop es 

Restore ES, then go restore 

jmp returnl 

AX and DS, and get back 

bs ends 


end start 


; End of File 



marks the "leftover" environment as its 
own. ENVRLS then simply terminates, 
and its ill-gotten environment block dis¬ 
appears with it 

As may be seen in the ENVRLS. ASM 
source code (Listing 5), an ERRORLEVEL 
value is returned to indicate the result 
of its operation. A value of zero means 
that the request was successfully ac¬ 
complished. ERRORLEVEL 1 indicates 
that the specified target name was less 
than one or more than eight characters 
in length; ERRORLEVEL 2 means that the 
name was valid but could not be found 
associated with an environment block. 

The search method used by ENVRLS 
should work with MS-DOS versions 3.x 
and newer, and has been tested with 
versions 3.3 and 5.0. Note that it is 
capable of finding and releasing en¬ 
vironment blocks of programs loaded 
into upper memory by the DOS-5.0 
LOADHIGH command. □ 


Finally, Windows and OS/2 
Training For a Reasonable Price. 


$500 

per student for five-day classes' 

$10,000 

for five-day onsite classes 2 


Our competitors charge up to $1850 for a class, but we 
are located in Cedar Rapids, IA, where our costs are low, so yours 
are, too. But these are the same high-quality, guaranteed workshops 
that we've been providing for IBM and other companies since 1983. 

Since that time, we have trained over 8,000 
programmers. And our class evaluations show that over 90 percent 
of our students were very satisfied with the class. 

To enroll, or to get a workshop schedule, call (319) 362- 
3906 or fax us at (319) 362-3701. P.O. Box 461 Marion, IA 52302 



DESCRIPTOR SYSTEMS 

"We Bring You Up to Speed" 


□ C Programming □ C++ Programming 
□ Windows Programming □ Windows NT Programming 
□ OS/2 Kernel Programming □ Presentation Manager Programming 
□ Workplace Shell Programming 


At Cedar Rapids. Introductory price until 5/93; $750 after that date 

At your site. Call for details Trademarks owned by their respective companies 


□ Request 123 on Reader Service Card □ 
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VISUAL PROGRAMMING FRAMEWORK 


Features: 

• Visual programming by connecting icons 

• Select process icon from process toolbar 

• Each icon represents an application process class 

• All processes inherited from generic process class 

• Framework maintains processes connection map 

• WYSIWYG interactive dialog box generator 

• Object-oriented programming using C+ + 

• Automatic program generator produces generic process 
class 

Advantages: 

• Wide range of application: data acq., simulation, network 
management, multimedia,... 

• Interactive construction of programs speeds development 
and increases productivity 

• Promotes the reuse of existing code modules 

• Using standardized interface, it provides an easy way to 
distribute large software project 

• Increase the ability of user to build application 

VPS SOFTWARE Library Comes With: 

• No Royalties, Money-back guarantee 

• FREE Source Code, FREE Tech Support 

• Runs under MS Windows 

• Support for both Borland and Microsoft C+ + 

• Only $99 

Call today for complete information, demo or to order. 


VPS 


SOFTWARE 


P.O. Box 526, Whippany, NJ 07981 
(201) 694-2721 FAX (201) 696-3650 


□ Request 143 on Reader Service Card □ 
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Designing 3-D Effects 

Don Metzler 


Introduction 

The sharp look sported by many current Windows applications derives from their 
use of 3-D effects. The Windows 3.1 startup screen itself replaces v3.0's white letter¬ 
ing on a dark blue background with a 3-D, embossed-looking placard. This article 
explains how to use the standard Windows 16-color VGA palette to create 3-D il¬ 
lusions, and provides sample code that illustrates the basics of building 3-D controls. 
The sample code can be used in Windows programs; it was developed for MS C/C++ 
7.0 compilers but can easily be modified for use with others. 

What Makes a Control Look 3-D? 

A number of techniques can be used to make a two-dimensional image look 
three-dimensional. The easiest of these techniques simulates the effects of a light 
source, creating highlights and shadows on a control or group of controls. The most 
basic 3-D control in Windows, the pushbutton, exemplifies this technique. It is a light 
gray object highlighted with white on the left and top borders and dark gray on the 
right and bottom borders. The implied light source is in the upper-left corner of the 
screen. 

The background of the display, whether it be a region or dialog box, is set to a 
medium intensity color having a value of RGB(0xC0, OxCO, 0x00). The main 
gray (monochrome) colors available in the standard VGA palette are as 
follows: 



Color Name 

RGB Value 

Black 

(0x00, 

0x00, 0x00) 

Dark Gray 

(0x7 F, 

0x7F, 0x7F) 

Light Gray 

(OxCO, 

OxCO, OxCO) 

White 

(OxFF, 

OxFF, OxFF) 


;E3s 

Microsoft C/C-w V7.0 
Borland C** v3.1 


Windows 3.0/3.1 


Don Metzler is Chief Engineer of Technological Computer Innovations (TCI), 
a company located in Lafayette, Colorado (near Boulder & Denver) which 
specializes in software development and multimedia programming for 
MS-Windows and other environments. They are currently developing 
several products for Windows, including Stellar Explorer v2.0 and 'Tiles 
and Tribulations." Don may be reached at (303) 673-9046, or via Compu¬ 
Serve, at 71174,2675. 
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Listing 1 3d.c 


I y**************************************************************************** 
// 3d.c 

// (c) 1992 by Technological Computer Innovations 
// Author: D. Metzler 

j y *********************************************** ***************************** 

♦include <windows.h> 

♦include <string.h> 

♦include <stdio.h> 

♦include "3d.h" 

void PlaceCornerRivets(HWNO hWnd) 

( 

HDC hDC ; 

RECT rc ; 

hDC - GetDC(hWnd) ; 

GetClientRectfhWnd, (LPRECT) ire) ; 

InflateRect((LPRECT) ire, -6, -6) ; 

DrawRivet(hDC, rc.left, rc.top) ; 

DrawRivet(hDC, rc.right, rc.top) ; 

DrawRivet(hDC, rc.right, rc.bottom) j 
DrawRivet(hDC, rc.left, rc.bottom) : 

ReleaseDC(hWnd, hDC) ; 


void DrawRivet(HDC hDC, int x, int y) 

( 

COLORREF color ; 
color ■ WHITE ; 

SetPixel(hDC, x-1, y, color) ; 
SetPixel(hDC, x-I, y-1, color) ; 
SetPixel(hDC, x, y-1, color) ; 

color * DKGRAY ; 

SetPixel(hDC, x+1, y, color) ; 
SetPixel(hDC, x+1, y+1, color) ; 
SetPixel(hDC, x, y+1, color) ; 

color - LTGRAY ; 

SetPixel(hDC, x, y, color) ; 


void Place3DText(HDC hDC, int x, int y, LPSTR string) 

( 

SetBkMode(hDC, TRANSPARENT) ; 

SetTextColor(hDC, WHITE) ; 

TextOutfhDC, x+1, y+1, (LPCSTR) string, lstrlen(string)) ; 
SetTextColor(hDC, BLUE) ; 

TextOut(hDC, x, y, (LPCSTR) string, lstrlen(string)) ; 

) 

void ShadowArea(HWNO hWnd, HDC hDC, int Ctrl ID. HBRUSH hbrush) 

1 

HWND hCtrl ; 

HPEN OldPen ; 

RECT rc ; 

HBRUSH OldBrush ; 

hCtrl * GetDlgItem(hWnd, ctrl_ID) ; 

GetClientRect(hCtrl, ire) ; 

OldBrush * SelectObject(hDC, hbrush) ; 

OldPen - SelectObject(hDC, GetStockObject(NULL_PEN)) ; 

ClientToDialog(hWnd, hCtrl, (LPRECT) ire) ; 

// Add shadows offset from bottom and right of client rectangle 

Rectangle(hDC, rc.left + 5, rc.bottom, rc.right + 6, rc.bottom + 6) ; 
Rectangle(hDC, rc.right, rc.top + 5, rc.right + 6, rc.bottom + 6) ; 

SelectObject (hDC, OldBrush) ; 

SelectObject (hDC, OldPen) ; 


void Recess(HWND hWnd, HDC hDC, int Ctrl id, int depth) 

{ 

int i ; 


Applying 3-D Effects 
to Existing Code 

You can give existing controls a 3-D 
appearance without going to the 
trouble of creating custom controls. 
Changing the default paint routine for 
an object is a simpler method of 
achieving the same effect, and no 
dynamic link libraries (DLLs) are required 
for dialog editors using this method. 
Once the code is built, you can simply 
call routines to paint an alternative 
looking control in your own code. You 
won't see the changes within a dialog 
editor, but you will be able to see the 
changes at run-time. 

Other ways of modifying a Windows 
control include: 

• Using custom code to handle the 
painting of an existing control either 
through callable routines or through 
owner-drawn controls 

• Subclassing a control and handling 
specific messages where necessary 

• Creating a new Windows class and 
procedure to handle all of the con¬ 
trol processing. 

The following examples show 
methods for handling the first of these 
methods. If you feel daring, you may 
convert the code into custom control 
classes. However, since the code 
presented here simply modifies the 
look of existing controls, there is no 
reason to create a custom class. 

3-D Group Boxes 

Standard group boxes provide a 
means of grouping objects within a 
dialog box but offer little in the way of 
visual interest. Many commercial 
products have changed the look of their 
group boxes to give them a more dis¬ 
tinct character — recessed, raised, 
grooved, and so forth. You can change 
the appearance of an existing group 
box with a MakeGroup3D() call. To en¬ 
sure that your painting code works 
properly, you must hide the original 
control using a ShowUindow(hWnd, 
SU_HIDE) call. This prevents Windows 
from painting the control and allows 
your function to handle it (another way 
around this would be to subclass the 
control and trap the UM_PAINT mes¬ 
sage). Within the dialog code where 


Page 66 — Windows/DOS Developer’s Journal 


January 1993 




you intend to change the look of an ob¬ 
ject, you would hide any controls that 
included alternative paint routines in 
UM_INITDIALOG's message trapping. Be 
careful, however, not to hide controls 
that have other than cosmetic effects. 
In the case of a recessed edit control, 
for example, you would eliminate the 
US_BORDER style from the control and 
not hide it, since you want to maintain 
its default Windows functionality. Group 
boxes and frames may be hidden, as 
they do not have interactive or 
dynamic characteristics. The actual call 
to MakeGroup3D() should occur in the 
WM_PAINT message after the Begin- 
Paint() call. The device context 
returned by BeginPaint() has a clip¬ 
ping region set for the invalid region. 
This ensures that the paint message 
paints only what needs to be updated. 

In order to repaint the control at the 
proper location and size, you'll need to 
know the area of the control. Get- 
ClientRect() will return this informa¬ 
tion. To get the handle of an individual 
control within a dialog, use GetDlg- 
Item(). You now have a RECT structure 
that defines the area of the control, if 
you get a device context and paint 
upon this area, you will be limited to 
this area and will not be able to paint 
beyond it. For present purposes, it 
would be better to have a device con¬ 
text for the dialog itself and paint using 
the dialog’s client RECT area. This means 
that the client coordinates for the RECT 
structure (where the upper-left corner 
will always be (0,0)) must be converted 
to dialog coordinates, which can be ac¬ 
complished by converting the RECT 
from client to screen coordinates and 
then converting the screen coordinates 
back to client coordinates for the dialog. 

To make the conversion process 
easier, I created a function called 
ClientToDiolog(). This function ac¬ 
cepts parameters for a dialog handle, a 
control handle, and a RECT structure 
(which must be filled with the Get- 
ClientRect() for the control itself). The 
values within the RECT structure will be 
altered so that the client area coordinates 
are converted to dialog coordinates and 
painting can be handled relative to the 
dialog box and its DC. The following 
code fragment makes a group box 3-D: 


Listing 1 continued 


RECT rc ; 

HPEN hPen, hOldPen ; 

HWND hCtrl ; 

hCtrl * GetDlgItem(hWnd, ctr1_id) ; 

GetClientRect(hCtrl, &rc) ; 

InflateRect((LPRECT) &rc, depth, depth) ; 

ClientToDialog(hWnd, hCtrl, (LPRECT) &rc) ; 

hPen = CreatePen(PS_SOLID, 1, OKGRAY) ; 

for(i=0;i<depth;i++) 

( 

hOldPen = SelectObjectfhDC, hPen) ; 

HoveTo(hDC, rc.left+i, rc.bottom-i) ; 
LineTojhDC, rc.left+i, rc.top+i) ; 

LineTo(hDC, rc.right-i, rc.top+i) j 
SelectObject(hDC, hOldPen) ; 

SelectObject(hDC, GetStockObject(WHITE_PEN)) ; 
LineTo(hOC, rc.right-i, rc.bottom-i) ; 
LineTojhDC, rc.left+i, rc.bottom-i) ; 

) 

DeleteObject(hPen) ; 


void Raise(HWND hWnd, HDC hDC, int Ctrl id, int depth) 

( 

int i ; 

RECT rc ; 

HPEN hPen, hOldPen ; 

HWND hCtrl : 

hCtrl = GetDlgItem(hWnd, ctrl_id) j 
GetClientRect(hCtrl, &rc) ; 

InflateRect((LPRECT) &rc, depth, depth) ; 
ClientToDialog(hWnd, hCtrl, (LPRECT) &rc) ; 

hPen = CreatePen(PS_SOLID, 1. DKGRAY) ; 

for(i=0;icdepth;i++) 

{ 

SelectObject(hDC, GetStockObject(WHITE_PEN)) ; 
MoveTo(hDC, rc.left+i, rc.bottom-i) ; 
LineTo(hDC, rc.left+i, rc.top+i) ; 

LineTo(hDC, rc.right-i, rc.top+i) ; 

hOldPen = SelectObject(hDC, hPen) ; 

LineTo(hDC, rc.right-i, rc.bottom-i) ; 
LineTo(hDC, rc.left+i, rc.bottom-i) ; 
SelectObject(hDC, hOldPen) j 

) 

DeleteObject(hPen) ; 


void MakeGroup3D(HWND hWnd, int Ctrl ID, int ftype) 

( 

HWND hCtrl ; 

char buffer[35], tmp[35] ; 

RECT rc ; 

POINT pt ; 

int xl, yl, x2, y2, i ; 

HDC hDC i 

HPEN hPen, hOldPen ; 

hCtrl * GetDlgltemfhWnd, Ctrl ID) ; 

GetWindov*Text(hCtrl, (LPSTR) buffer, sizeof(buffer)) ; 

/* If there is a label on the groupbox, add spaces to front and back */ 
if (strlen(buffer) > 0) 

( 

sprintf(tmp, " %s “, buffer) ; 
strcpy(buffer, tmp) ; 

1 

// Paint a 3-D rectangle around the control 
GetClientRect(hCtrl, (LPRECT) &rc) ; 

ClientTo0ialog(hWnd, hCtrl, (LPRECT) &rc) ; 
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WMINITDIALOG: 

ShowWindow(GetDlgItem(hDlg, ID_GROUPBOX), 
SWHIDE) ; 
return (TRUE) ; 

WM_PAINT: 

BeingPaint(hDlg, &ps) ; 

MakeGroup3D(hDlg, ps.hdc, GetDlgItem(hDlg, 
ID_GROUPBOX)) ; 

EndPaint(hDlg, &ps) ; 

Shadow Effects 

You can make a dialog control look as though it were cast¬ 
ing a shadow or “floating" above the dialog box (this is also 


called a drop-shadow). The side of the control opposite the 
“light source" will be the location for the shadow. I provide a 
function called ShadowArea() to create such a shadow from a 
dialog control. One of the parameters passed to ShadowArea() 
is an integer value for a dialog control ID. The function gets 
the screen coordinates of the control ID and paints two full 
rectangles offset from the control to produce a shadow to the 
lower right of the control. The first rectangle is offset to the 
bottom and shifted left from the control client area; the 
second is offset from the right side and shifted down from the 
client area. Again, the implied light source is presumed to be 
in the upper-left corner of the screen, so that the shadow 
would fall to the right and below an object. The controls that 
look best shadowed are pushbuttons and list boxes. 


Recessed Frames 

Recessed frames make a given area 
looked “recessed," or set into the dialog. 
The wider the border of the frame, the 
deeper the recess looks (though if the 
recession is too deep, the illusion of the 
effect will be lost). Recessed frames 
give 3-D depth by setting a given area 
to be “below” the other components 
within a given window. In this example, 
you can recess frames within dialogs 
and use the recessed areas to group 
various controls. Placing shadowed but¬ 
tons within a recessed area creates an 
especially nice effect, making the but¬ 
tons look as if they were floating above 
the recession. Also note the colors used 
for a recession. There are dark gray 
lines on the left and top sides of the 
area and white lines on the right and 
bottom sides. If these were to be 
reversed, the area would look raised 
rather than recessed. Again, this effect 
assumes that the light source is in the 
upper-left corner of the screen. 

Comer Rivets 

Some NeXT applications have what 
appear to be screw heads in the 
corners of the application window — a 
visual effect that helps to give the user 
a 3-D perspective. This section tells you 
how to put 3-D rivets in the corners of 
a window. The code is contained in a 
simple routine that needs only the 
handle to the window within which you 
want to place the rivets. The rivets are 
highlighted on the top and left sides 
and shadowed on the bottom and right 
sides. Call PlaceCornerRivets() from a 
UM_PAINT message to the dialog or win¬ 
dow where the rivets will be placed, 
but do not make the call between the 


Listing 1 continued 


xl = rc.left ; 
yl * rc.top ; 
x2 = re.right ; 
y2 ■ rc.bottom ; 

pt.y * yl + 1 : 
yl +- 7 ; 

hDC - GetDC(hWnd) ; 

rc.left * xl ; 
rc.top * yl ; 
rc.right - x2 ; 
rc.bottom ■ y2 ; 

InflsteRect((LPRECT) ire, -2, -2) ; 
for(i=0;i<6;i++) 

( 

FrameRect(hDC, (LPRECT) &rc, GetStockObject(LTGRAY BRUSH)) ; 
InflateRect((LPRECT) ire, +1, +1) ; 

I 

switch(ftype) 

( 

case 0: 

// Draw outside white line 

hPen - SelectObject(hDC, GetStockObject(WHITE PEN)) ; 
MoveTo(hDC, xl-1, y2+l) ; 

LineTojhDC, xl-1, yl-1) ; 

LineTojhDC, x2+2, yl-1) ; 

// Draw inside white line 

MoveTo(hDC, x2-l, yl+1) ; 

LineTojhDC, x2-l, y2-l) ; 

LineTojhDC, xl+1, y2-l) ; 

hPen - CreatePen(PS_$OLID, 1, DKGRAY) ; 
hOldPen = SelectObject(hDC, hPen) ; 

// Draw outside dark-gray line 

MoveTo(hDC, x2+l, yl) ; 

LineTojhDC, x2+l, y2+l) ; 

LineTojhDC, xl-1, y2+l) ; 

// Draw inside dark-gray line 

MoveTo(hDC, xl+1, y2-l) ; 

LineTojhDC, xl+1, yl+1) ; 

LineTojhDC, x2-l, yl+1) ; 

SelectObject(hDC, hOldPen) ; 

DeleteObjectjhPen) ; 

hPen = CreatePen(PS_SOLID, 1, LTGRAY) ; 

hOldPen « SelectObject(hDC, hPen) ; 
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BeginPaintf) and EndPaint() calls. 
The reason for this is that Begin- 
Paint() gets a device context to the 
paint area and since device contexts 
are a limited resource in Windows, it is 
best not to have too many in use at 
the same time. 

As stated earlier, the 3-D effects 
presented here look best against a light 
gray background. To paint a window 
light gray, include the following mes¬ 
sage handling: 


case WM_CTLC0L0R: 

switch(HIWORD(lParam)) { 
case CTLC0L0R_DLG: 

return(GetStockObj ect (LTGRAYJRUSH)) ; 
default: 

return (NULL) ; 

} 

break ; 

As the Microsoft documentation states, 
if you process the UM_CTLCOLOR mes¬ 
sage, it is important that you return 
either a handle to a brush or NULL. 
Failure to do so can cause unpre¬ 
dictable results. 


Listing 1 continued 


II Draw middle light-gray lines 

MoveTo(hDC, xl, yl) ; 

LineTojhDC, x2. yl) ; 

LineTojhDC, x2, y2) ; 

LineTojhDC, xl, y2) ; 

LineTojhDC, xl, yl) ; 
break ; 

case 1: 

rc.left * xl ; 
rc.top - yl ; 
rc.right * x2 ; 
rc.bottom * y2 ; 

FrameRect(hDC, (LPRECT) ire, GetStockObject(WHITE_BRUSH)) ; 

hPen = CreatePen(PS_$OLID, 1, DKGRAY) ; 
hOldPen * SelectObject(hDC, hPen) ; 

MoveTo(hDC, xl - 1, y2 - 1) ; 

LineTojhDC, xl - 1, yl - 1) ; 

LineTojhDC, x2, yl - 1) ; 

MoveTo(hOC, xl + 1, y2 - 2) ; 

LineTojhDC, x2 - 2. y2 - 2) ; 

LineTojhDC, x2 - 2, yl + 1) ; 

break ; 

) 

SelectObject(hDC, hOldPen) ; 

DeleteObjectjhPen) ; 

// Handle 3D text 
SetTextColor(hDC, DKGRAY) ; 

SetBkColorfhDC, LTGRAY) ; 

TextOut(hDC, xl+3, pt.y+1, (LPSTR) buffer, strlen(buffer)) ; 
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3-D Text 

Giving text output a 3-D effect is also 
quite a simple process. Choose two 
colors for the text — the first for the 
shadow, the second for the highlighted 
text Next, set the background mode to 
TRANSPARENT using the following func¬ 
tion call: 

SetBkMode(hDC, TRANSPARENT) ; 

This will allow the text to be drawn on 
top of itself in different colors: 

/* Select the shadow color */ 

SetTextColor(hDC, SHAD0W_C0L0R) ; 
/* Offset shadow down and to 
right of text */ 

TextOut(hDC, x+1, y+1, string, 
strlen(string)) ; 

/* Select the text color */ 
SetTextColor(hDC, HIGH- 
LIGHT_C0L0R) ; 

/* Output main text on top of the 
shadow */ 

TextOut(hDC, x, y, string, 
strlen(string)) ; 


Notice to Our 
Subscribers 

Occasionally, Windows/DOS 
Developer’s Journal makes its 
mailing list available to vendors 
of products we think our 
readers will find interesting. Cur¬ 
rent subscribers receive free in¬ 
formation in the mail from 
these vendors. 

If you prefer that your name 
not be used in these mailings, 
please let us know. Just copy or 
clip this form and send it with 
your name and address to: 


Windows/DOS 

□ DEVELOPER'S JOURNAL 

1601 W. 23rd. St., Suite 200 
Lawrence, KS 66046-2743 


Listing 1 continued 


SetBkMode(hDC, TRANSPARENT) ; 

SetTextCo1or(hDC, WHITE) ; 

TextOut(hDC, xl+1, pt.y-1, (LPSTR) buffer, strlen(buffer)) ; 
SetTextColor(hDC, BLACK) ; 

TextOut(hDC, xl+2, pt.y, (LPSTR) buffer, strlen(buffer)) ; 
ReleaseDC(hWnd, hDC) ; 


void ClientToDialog(HWND hDlg, HWND hCtrl, LPRECT Iprc) 

I 

// Convert coordinates of a window control to coordinates of 
// its parent dialog window. 

// hDlg : Handle to the dialog box 

// hCtrl : Handle to the control 

// lprc : ClientRect for the control: GetClientRect(hCtrl, &rc) ; 

RECT rc ; 

POINT pt ; 

// Convert upper-left point of the RECT 
pt.x ■ lprc->left ; 
pt.y * lprc->top ; 

ClientToScreen(hCtrl, (LPPOINT) &pt) ; 

ScreenToClient(hDlg, (LPPOINT) &pt) ; 

// Save the converted point in “rc" 
rc.left ■ pt.x ; 
rc.top = pt.y ; 

// Convert the lower-right point of the RECT 
pt.x = lprc->right ; 
pt.y ■ lprc->bottom ; 

ClientToScreen(hCtrl, (LPPOINT) &pt) ; 

ScreenToClientjhDlg, (LPPOINT) &pt) ; 

rc.right * pt.x ; 
rc.bottom * pt.y ; 

// Copy the new RECT to the calling RECT to return 
CopyRectOprc, (LPRECT) &rc) ; 


/* End of File */ 


Listing 2 3d.h 


jj ★★*★*★★*★*★***★*★★*★★*★★★★★*★★★*★**★*★★*★**★*★*★*****★★★*★★★*★****★★★★★★*★★* 

// 3d.h 

// (c) 1992 by Technological Computer Innovations 
// Author: D. Hetzler 

^^★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★***************************************** 

linclude "colordef.h" 

void PIaceCornerRivets(HWND) ; 
void DrawRivet(HDC, int, int) ; 
void Place3DText(HDC, int, int, LPSTR) ; 
void ShadowArea(HWND, HDC, int, HBRUSH) ; 
void Recess(HWND, HDC, int, int) ; 
void Raise(HWND, HDC, int, int) ; 
void MakeGroup3D(HWND, int, int) ; 
void ClientToDialog(HWND, HWND, LPRECT) ; 

Idefine CWJCREEN 0 
Idefine CW_MAIN 1 

/* End of File */ 
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Listing 3 colordef.h 

! J* ****** ************ ******* ************ ****************** 

// colordef.h 


// (c) 1992 by Technological Computer Innovations 
// Author: D. Metzler 

! i ******************************************************** 

Idefine BLACK 

RGB(0x00, 0x00, 0x00) 

Idefine RED 

RGB(0xFF, 0x00, 0x00) 

Idefine GREEN 

RGB(0x00, OxFF, 0x00) 

Idefine YELLOW 

RGB(0xFF, OxFF, 0x00) 

#define DKGRAY 

RGB(0x7F, 0x7F, 0x7F) 

Idefine LTGRAY 

RGB(0xC0, OxCO, OxCO) 

Idefine DKRED 

RGB(0x7F, 0x00, 0x00) 

Idefine MAGENTA 

RGB(0xFF, 0x00, OxFF) 

Idefine PURPLE 

RGB(0x7F, 0x00, 0x7F) 

Idefine BLUE 

RGB(OxOO, 0x00, OxFF) 

Idefine DKBLUE 

RGB(0x00, 0x00, 0x7F) 

Idefine INDIGO 

RGB(0x00, OxFF, OxFF) 

Idefine DKINDIGO 

RGB(0x00, 0x7F, 0x7F) 

Idefine WHITE 

RGB(0xFF, OxFF, OxFF) 

Idefine DKGREEN 

RGB(0x00, 0x7F, 0x00) 

Idefine DKYELLOW 

RGB(0x7F, 0x7F, 0x00) 

/* End of File */ 



I will leave it to eager programmers to convert the above into 
a function so that a static text control can display 3-D text. 

Conclusion 

Listing 1 is the source code for 3-D effects described here, 
and Listing 2 is the header file. Listing 3, colordef.h, contains 
definitions for the RGB values for the standard 16 colors used 
in the Windows VGA system palette; it is included so that you 
won't have to decipher an RGB value every time you want to 
use a default color that is not a stock object. Feel free to 
modify the code and use it freely in your own programs. If 
you come up with something really unique, please let me 
know via mail or e-mail. I can be reached via CompuServe at 
71174,2675. □ 


Source Code Availability 


For our readers’ convenience, WDDJ code is now 
available via a variety of resources, including BBS's, 
ComputServe, the Internet, and WIX —all places where 
programmers gather to ask and answer questions 
about DOS and Windows programming. 

The list of systems where you can obtain code list¬ 
ings is shown below. If you get your code from one of 
these sources, please take some time to look around 
and see what else they have to offer. Our thanks to 
the hard-working operators who run these BBS’s and 


make them a great source of technical information. 
Thanks also to: Larry O'Brien of Computer Language, 
who was kind enough to give us space in the Com¬ 
puter Language forum on CompuServe; to Jim Kyle for 
invaluable help with the mechanics of the CompuServe 
forum; and to Tony Lockwood for handling the 
mechanics of BIX/WIX. 

Code disk subscriptions and code disks for in¬ 
dividual issues can be ordered from R&D Publications 
(913) 841-1631. 


Bulletin Board Systems 

Phoenix Chapter ACM Library 

(602) 970-0474 

The Programmer’s Corner 

(301) 596-7692 or (410) 995-6873 

The Courts of Chaos 

(501) 985-0059 

EmmaSoft Shareware Board 

(607) 533-7072 

Cornerstone 

(206) 362-4283 

Other Systems 

CompuServe 

go clmforum, section 7 

BIX/WIX 

join listings, change areas to "win.dos.dev” 

uunet 

~/published/windowsdos/19YY/monYY.zip 

Accessible via anonymous FTP from ftp.uu.net or via uucp from (900) GOT-SRCS 
(login name “uccp”, no password, $.50 per minute). 
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New Products 

Industry-Related News & Announcements 


Help for Creating Windows Help Files 

The Windows Help Magician is a new tool from Software 
Interphase for creating Windows help files. The Help 
Magician is an integrated system that lets developers create 
and edit help source files, import ASCII and RTF files, test the 
resulting help system, run the Windows help compiler, and 
call winhelp.exe, all from within the Help Magician. You don't 
have to switch to DOS to run hcexe. 

The built-in editor performs dynamic syntax checking to 
ensure the compiled help system will be accurate. It sup¬ 
ports cut, copy, find, find next, find previous, replace with 
verify, and replace all. You can indent individual words, para¬ 
graphs, or blocks of text, and create bulleted and numbered 
lists. You can also define, save, and load font styles. 


The Help Magician can import ASCII text and RTF files 
created by Word for Windows. You can import manuals 
created by Word and turn them into online help. The Help 
Magician can generate RTF Files that Microsoft Word can 
read. The Help Magician can generate printouts for the entire 
help file, browse sequences, context relationships, and a 
linked list 

The Windows Help Magician costs $199 and works with 
all Windows languages; it does not require Microsoft Word 
or Word for Windows and it supports both Windows 3.0 and 
Windows 3.1. For more information, contact Software Inter¬ 
phase, Inc., 82 Cucumber Hill Road, Foster, Rl 02825, (401) 
397-2340; FAX (401) 397-6814. 


Database Custom Controls for Visual Basic 

Coromandel has released DbControls, a set of multi-user 
database custom controls and database functions for Visual 
Basic Visual Basic users can use DbControls to build 
database applications without writing any code. DbControls 
comes with support for dBase, Btrieve, and ObjecTrieve data 
managers. 

The Field Definition control can build the database struc¬ 
ture and automatically create or rgister data and index files. 

Even complex multi-part indexes can be created. The 


Database Operation control lets you build command buttons 
on the Visual Basic form to which properties such as Open, 
Close, Insert, Delete, Update, Read, and Query can be at¬ 
tached. 

DbControls costs $199. For more information, contact 

Coromandel Industries, Inc, 70-15 Austin Street, Third 
Floor, Forest Hills, NY 11375, (718) 793-7963; FAX (718) 
793-9710. 


Interrupt Trapper Aids DOS/Windows Debugging 


INTRCPT is a new memory-resident interrupt trapper and 
debugger that works with both DOS and Windows and in¬ 
cludes an integrated memory map, vector map, and user- 
maintained function database. You can use INTRCPT to 
monitor, trap, call, and log interrupts at the interrupt, func¬ 
tion, or subfunction level. You can set breakpoints individual¬ 
ly or in combination. INTRCPT can log interrupts to a disk file 
with all register and buffer values shown before and after 
the specified interrupt executes. 

A trap option puts INTRCPT into debugger mode, letting 
you manipulate registers and memory values. The debugger 
load-and-execute option allows you to run a disassembler 
for real-time disassembly of the currently executing target 


application. The call option can invoke any interrupt and dis¬ 
play the registers and memory buffers after the interrupt 
returns. 

INTRCPT programs the VGA display a 26th line for status 
information. The status line displays the activity of the 
monitor, log, and trap options. INTRCPT includes special 
provisions for NetWare, Btrieve, and NetBIOS calls and can 
also log Windows 3.1 enhanced mode interrupts. 

INTRCPT costs $99 and is compatible with all VGA and 
VESA modes. For more information, contact Hackensack, 
6905 Silber Road, Suite 114, Arlington, TX 76017, (800) 
325-4225. 
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VBASIC Library Goes to CD-ROM 

EMS Professional Shareware has added a CD-ROM version 
of its updated and expanded VBASIC Library, a collection of 
291 public domain and shareware programs, utilities, and 
other File collections specifically for users of Microsoft’s 
Visual BASIC The library is compressed with PKZIP to fit over 
20Mb onto 29 360Kb or 8 1.44Mb diskettes. A Windows- 
based database directory and lookup program lets program¬ 
mers locate a particular type of utility or program by type, 


vendor, name, or through free text search across product 
descriptions. 

The library costs $59.50 on either 1.44Mb or 360Kb disket¬ 
tes. The CD-ROM version of the library costs $150 and in¬ 
cludes an additional 780 Windows shareware programs. All 
EMS products come with a 30-day, money-back guarantee. 
For more information, contact EMS Professional Shareware, 
4505 Buckhurst Court, Olney, MD 20832, (301) 924-3594; 
FAX (301) 963-2/08. 


Windows Database Engine Offers Stored Procedures 


The Andsor Database Engine is a new Windows DLL that 
gives programmers database management capabilities via 
DLL function calls. The engine offers a database language, 
ADL, with which you can write simple procedures to perform 
reports, queries, updates, and so on. You an embed ADL 
procedures in your program or store them in the database it¬ 
self to produce smaller and simpler Windows programs. 
Another advantage of storing the procedures in the 
database is that multiple applications can use the same 
database procedures. 

The package includes InterAct, a database management 
utility that lets you create, test, and modify stored proce¬ 


dures without having to recompile your program. The 
Andsor Database Engine also provides traditional ISAM file 
operations for programs that do not want to take advantage 
of stored procedures. 

The Andsor Database Engine vl.O costs $149 and is com¬ 
patible with any language that ran call DLL functions. For 
more information, contact Andsor Research Inc., 390 Bay 
Street, Suite 2000, Toronto, Ontario M5H 2Y2, Canada, 
(800) 766-1141 or (416) 245-8073; FAX (416) 240-8473. 
(314) 334-6317; FAX (314) 334-0794. 


Prototyper Converts ObjectVision to Source Code 


Buzzwords International, Inc, has announced WinGEN, a 
GUI DBMS application generator that ran convert existing 
ObjectVision .ovd Files to source code or help you create 
new applications from scratch. WinGEN creates portable 
source code for Windows, OS/2, or UNIX applications. It in¬ 
cludes a visual WYSIWYG screen designer and the ability to 
rapture and incorporate screens at any resolution. 

WinGEN supports DDE, DDEML, and OLE, and generates 
commented object-oriented source for dBASE for Windows, 


C, C++, and Turbo Pascal for Windows. WinGEN applications 
ran access dBASE, Paradox, BTRIEVE, or ASCII flat files from all 
supported languages. The generated source code ran also 
take advantage of the Borland custom control package 
(bwccdll). 

WinGEN costs $149, plus $100 for each database 
module (dBASE, Paradox, etc). For more information, contact 

Buzzwords International, Inc, R1 #215 T Oriole Road, Cape 
Girardeau, MO 63701, (314) 334-6317; FAX (314) 334-0794. 


BASIC Library Compresses and Decompresses Data 


Crescent Software, Inc, has released The Compression 
Workshop, a new library for Microsoft compiled BASIC and 
Visual Basic for DOS. The package includes four major com¬ 
ponents: a set of subroutines and functions that BASIC 
programs ran call to compress and decompress array, string, 
file, and video memory data; a complete Install utility that 
developers ran use to distribute their own applications in 
compressed format; subroutines to back up and restore disk 
data in compressed format; and demonstration programs 
that show how the Compression Workshop routines work. 


Numeric, TYPE, and Fixed-length string arrays ran be 
stored in compressed form on disk either individually or in 
groups within a single File. One or more data and program 
files may also be combined into a single compressed file. A 
compressed file that holds other files ran be converted to a 
self-extracting .exe program that will unpack itself when run, 
placing all of the files it contains into the current directory. 

The Compression Workshop costs $149, and includes 
source code. For more information, contact Crescent 
Software, Inc., 32 Seventy Acres, West Redding, CT 06896, 
(203) 438-53 00; FAX (203) 431-4626; CIS 72657,3070. 


DLLs Offer Low-Level Systems Support 

Win/Sys Library from TurboPower Software is a new 
library of systems-level functions for Windows programmers. 
Win/Sys Library provides DLLs that offer DPMI access, heap 
analysis tools, date and time manipulation, error trapping 
and recovery, huge arrays, string manipulation, and fast sort¬ 
ing. 


Win/Sys Library costs $149 and includes full source code, 
documentation, popup help, example programs, and free 
telephone and CompuServe support For more information, 
contact TurboPower Software, P.O. Box 49009, Colorado 
Springs, CO 80949-9009, (719) 260-6641; FAX (719) 260- 
7151. 
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DynaMind Facilitates Neural Network Development 


NeuroDynamX, Inc, is shipping DynaMind Developer, a 
PC-based neural network application development tool. The 
package includes DynaMind v3.0, a software package for 
training and implementing neural network solutions; Neuro- 
Link v2.0, a library of C routines that load, probe, and test 
networks, and can link multiple networks serially or in paral¬ 
lel; Neural Network Hardware Emulation, the ability to emu¬ 
late neural network hardware devices including the 
80170NX and the ETANN multichip board from Intel; DftBuild, 
which creates ready-to-run neural network filters designed 


to perform a Discrete Fourier Transform (DFT) that can be em¬ 
bedded in applications using NeuroLink v2.0. 

DynaMind Developer costs $495 and requires an 80286 
or better with at least 640Kb of memory and an EGA or VGA 
monitor; DynaMind v3.0 software can be purchased separate¬ 
ly for $145. NeuroLink compiles with Borland Turbo C v2.0, 
Turbo C++, and Borland C++. For more information, contact 
NeuroDynamX, Inc., P.O. Box 323, Boulder, CO 80306, (303) 
442-3539, (800) 747-3531; FAX (303) 442-2854. 


GUI Computer Updates ObjectTable C/C++ 


ObjectTable C/C++ is a Windows library that provides ap¬ 
plications with a programmable, multicolumn table object 
for database front ends. The library supports automatic data 
validation for date, time, currency, and scientific notation 
data formats; cut and paste to the Windows clipboard; 
greater than 32Kb capacity; and horizontal and vertical scroll¬ 
ing. 


The C version of Object Table C/C++ costs $79 or $199 
with source; the C++ version costs $99 or $259 with source. 
The package supports Borland ObjectWindows Library (OWL) 
and the Microsoft Foundation Classes (MFC). For more infor¬ 
mation, contact GUI Computer, Inc., P.O. Box 795908, Dal¬ 
las, TX 75379, (800) 800-9010; FAX (214) 250-1355; BBS 
(214) 250-2077. 


Blaise Enhances Asynch Manager 

Blaise Computing, Inc., is shipping C ASYNCH MANAGER 
v4.0, for serial communications applications written with Bor¬ 
land and Microsoft C and C++ compilers. The new version 
supports XMODEM, YMODEM, ZMODEM, and Kermit file trans¬ 
fer protocols. The routines are state-driven and allow 
programmers to perform transfers in the background or to 
execute multiple transfers simultaneously at any baud rate. 


Windows NT XVT Portability Toolkit 

XVT Software Inc is now supporting Windows NT with 
its XVT Portability Toolkit, which allows programmers to 
build a single C or C++ application, then recompile for every 
major GUI without rewriting code. XVT/NT supports all Por¬ 
tability Toolkit Release 3.x functions. 


The package also includes all new modem control functions 
and enhanced support for the 16550A UART as well as sup¬ 
port for multiport boards such as the Digiboard PC/X. 

C ASYNC MANAGER v4.0 costs $219 and includes source 
code. For more information, contact Blaise Computing Inc, 
819 Bancroft Way, Berkeley, CA 94710, (510) 540-5441; 
FAX (510) 540-1938. 


The Portability Toolkit for NT costs $1,450 on Intel '486 
systems and $4,400 on workstations such as DEC and MIPS. 
XVT does not charge royalties. For more information, contact 

XVT Software Inc., 4900 Pearl East Circle, P.O. Box 18750, 
Boulder, CO 80308, (303) 443-4223; FAX (303) 443-0969. 


Compass Point Introduces application::ctor 

application::ctor (pronounced “application constructor”) is 
a new GUI application development tool designed to handle 
the Windows graphical environment for application 
developers. You can use the product's View Editor to con¬ 
struct the application’s user interface and attach predefined 
prototyping functions from the product's class libraries. Once 
the prototype’s functionality and appearance are complete, 
you can attach C++ code to the events in the View Editor to 
build the deliverable application. 

The product includes the object-oriented View Editor, a 
user interface class library containing over 100 classes, and a 
C++ class browser. Windows objects built with applica- 


tion::ctor, including MDI windows, can have all the 
functionality of Windows dialog boxes, including tab stops 
and control grouping. Also, controls in these windows can be 
related to each other and to the window itself with ‘attach¬ 
ment’ and “gravity,” allowing the window layout to automat¬ 
ically rearrange or resize the controls when the window is 
resized. 

application::Ctor costs $99 and requires Windows v3.1 
and a C++ compiler. For more information, contact Compass 
Point Software, 332A Hungerford Drive, Rockville, MD 
20850,(301)738-9109. 


ChartBuilder Adds Graph Types, Curve Fitting 


Pinnacle Publishing, Inc, is shipping ChartBuilder v2.0 for 
Visual Basic, a Visual Basic custom control dedicated to busi¬ 
ness graphing and charting. The control provides area 
graphs, bar graphs, pie charts, high-low-close graphs, X-Y 
graphs, and polar graphs. The new version includes three 
new graph types: bubble graphs, tape graphs, and 3-D area 


graphs. The new version also contains improved axis and 
font control, multiple graphs, and curve fitting. 

Chart Builder v2.0 for Visual Basic costs $ 149 and is royal¬ 
ty-free; upgrades cost $49. For more information, contact Pin¬ 
nacle Publishing, Inc., P.O. Box 1088, Kent, WA 98035, 

(206) 251-1900; FAX (206) 251-5057. 
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Data Entry Workshop Offers Input Control 


TurboPower Software has released Data Entry Workshop, 
a collection of tools that makes it easy to create validated 
data entry screens for Windows. You use the package in 
three steps. First, use Resource Workshop to place and edit 
controls interactively. Second, run the supplied MAKESRC 
utility to automatically generate the C++ or Pascal source 
code. Finally, use Borland’s ObjectWindows Library to access 
the controls. The package works with Borland C++, Turbo Pas¬ 
cal for Windows, and Turbo C++ for Windows. 


Data Entry Workshop costs $189 and includes full source 
code, documentation, popup help, example programs, and 
free telephone and CompuServe support. For more informa¬ 
tion, contact TurboPower Software, P.O. Box 49009, 
Colorado Springs, CO 80949-9009, (800) 333-4160 or (719) 
260-6641; FAX (719) 260-7151. 


Graphics Screen Design for Basic 

Graphics QuickScreen (GQS) is a new graphics screen 
designer for Microsoft compiled Basic and Visual Basic for 
DOS. GQS lets developers create graphical data entry screens 
for their QuickBASIC, PDS, and VB/DOS programs. Developers 
can create entry screens with pictures and text in any com¬ 
bination of foreground and background colors, import 
graphic images, and define data-entry fields, pushbuttons, 
and scrolling menus. The screen designer allows developers 
to use boxes, circles, ellipses, arcs, polygons, lines, scrollable 
bars, and scalable fonts. 

The package includes 23 predefined data entry fields and 
automatic field calculations for spreadsheet-like capabilities. 
Field types include string, proper string, upper-case, numeric 
string, scrolling single-line text, integer, long integer, single 
and double precision, currency, American and European 
date, phone, zip code, social security, logical, multiple choice, 
memo (multiline text), horizontal and vertical scroll bars, and 


pushbuttons. Optional attributes may be applied to most 
fields to identify the fields as relational, indexed, or 
protected (read-only). Because field definitions are separate 
from the form handling code, the same data entry routines 
can be used for all screens. 

GQS offers a color palette including 127 dithered colors 
and 28 tile patterns. You can also assign all of the EGA's 64 
colors or the VGA’s 32K colors to the standard 16-color draw¬ 
ing palette. GQS includes a conversion utility to covert from 
the text mode version of QuickScreen into graphics mode. 
The package also includes a TSR for capturing any BASIC-sup- 
ported graphics screen and storing it in a .pcx file. 

Graphics QuickScreen costs $149, and includes source 
code. For more information, contact Crescent Software, Inc, 
32 Seventy Acres, West Redding, CT 06896, (203) 438- 
5300; FAX (203) 431-4626; OS 72657,3070. 


C-scape v4.0 Ships 

Liant Software has released version 4.0 of its C-scape 
User Interface Management System, an object-oriented C 
development tool for rapidly creating portable text and 
graphics-based user interface applications. C-scape provides 
an interactive screen and menu editor that generates C 
source code that makes appropriate calls to C-scape. The C- 
scape C library is a collection of functions for working with 
windows, data entry screens, graphical images, menus, input 
validation, text editing, and context-sensitive help. 

The new version offers improved application -look and 
feel’ with new CUA-style borders for both text and graphics 


mode, scroll bars, minimize/maximize buttons, and menus. 
The new version also adds support for Microsoft C/C++ v7.0 
and Watcom C v9.0 New classes allow you to display large 
data files quickly, attach user-defined functionality to win¬ 
dows, and display images from .pcx files. 

C-scape v4.0 costs $499 for DOS, $999 for Extended DOS, 
$1,499 for UNIX, and $2,499 for VMS. For more information, 
contact Liant Software Corporation, 959 Concord Street, 
Framinghom, MA 01701-4613, (508) 872-8700; FAX (508) 
626-2221. 


WinMonitor Spies on DLL Calls 

WinMonitor is a new utility that can monitor and inspect 
calls to Windows DLL functions. WinMonitor can display the 
parameters passed to functions as well as the values 
returned. WinMonitor is shipped with the configuration files 
that enable it to trace function calls made to the basic Win¬ 
dows API, but you can also import functions from other DLLs. 
The program provides filtering capabilities to help monitor 


only the function calls of interest It also can provide perfor¬ 
mance analysis information to help locate CPU bottlenecks. 

WinMonitor costs $189 per user and requires Windows 
3.1 and 2Mb of disk space. For more information, contact 

Windexperts Incorporated, 219 D Valley Drive, Atlantic 
Highlands, NJ 07716, (908) 872-2545; FAX (908) 872-8579. 
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Readers' Forum 


Dear Mr. Burk; 

I very much enjoyed Helen K. 
Custer's article, “Inside Windows NT: An 
Introduction” in the July issue of WDDJ. 
The article clearly demonstrates the 
huge differences in the underlying ar¬ 
chitecture of Windows NT versus DOS, 
and the resulting enhanced services 
that the operating environment will 
provide. 

After several years of working in the 
VAX/VMS environment (where most of 
the advantages of Windows NT exist al¬ 
ready), I do feel compelled to add a 
couple of caveats to the description of 
enhanced reliability and security that 
are promised with Windows NT in Ms. 
Custer's article. The basis of this im¬ 
proved robustness is that the system 
arranges for a separate address space 
for each application, and particularly for 
not allowing access at all to the 
executive's data structures from the 
user applications. Thus, it is very difficult 
for applications to impact each other or 
the underlying system. 

The first caveat is that the executive 
itself must have global access to all of 
the address spaces in order to do its 
job. It creates and destroys these ad¬ 
dress spaces, loads code and data into 
them, assigns and shuffles the physical 
memory actually being used, and a lot 
of other things. It must be free to step 
all over itself, as well as user applica¬ 
tions. Unless it is bug-free, it will do 
that on occasion. 

The second caveat (and the more 
problematic, in my experience) is that in 
order to manage the system, there will 
be tools available that will also be al¬ 
lowed to reach beyond their own ad¬ 
dress space into the rest of the system. 
There has to be a way to set 
passwords, terminate errant applica¬ 
tions, manipulate I/O devices, etc. A 
(usually sincerely-well-meaning) user 
will “hose” the system from time to 
time with these utilities. 


This is not to say that there is some¬ 
thing wrong with the direction that 
Windows NT is taking; on the contrary, 
it is a wonderful advance and I can't 
wait to get it up and running on my 
machine. I guess I felt the need to 
remind us that the technology hasn’t 
quite figured out how to keep those 
pesky, error-prone human beings from 
messing up the system. And thanks again 
for Ms. Custer's fine article; I found it an 
excellent introduction to Windows NT. 
Sincerely, 

Greg Skyles 
300 Los Ranchos Rd. NW 
Albuquerque, NM 87107-6516 
INTERNET: gskyles%intel9@intel.com 
You’re right. The NT Executive, like 
any operating system kernel, must be 
able to manipulate all of physical 
memory. Because of this, bugs can 
wreak significant havoc. This is one area 
in which experienced operating system 
developers can really make a difference 
over inexperienced ones. Of course, ex¬ 
tensive operating system testing is an 
absolute requirement before a new sys¬ 
tem can be released commercially. 

Although system administration is an 
area of vulnerability for all operating 
systems, on Windows NT, the user 
must log on as a system administrator 
in order to run tools that can alter sys¬ 
tem data. By logging on as an ad¬ 
ministrator, the user proclaims him- or 
herself to be a trusted user. This 
doesn't prevent an ignorant ad¬ 
ministrator from doing the wrong thing, 
but it does draw a clear line between 
who may and who may not alter such 
system information as passwords, the 
system time, and so on. —Helen 
Custer 


Mr. Burk, 

I read with interest the article 
“Stylish Dialog Boxes" by Patrick Burrell. 
I found a number of issues regarding 
the code within this article I thought 
you might be interested in. 


FYI — I am using Borland C++ version 
3.1. Some of this information may be 
specific to this compiler (but I doubt it). 
This information is dealing specifically 
with Listing 2. 

1) Without STRICT #defined (either 
on the compiler command line or in¬ 
cluded prior to including <windows.h>), 
a number of errors will occur dealing 
with the CallWindowProcO calls. This 
would be the only situation where a dif¬ 
ferent compiler (or version of a compiler) 
might make a difference. For example, 
this may be specific to Windows 3.1. 

2) Within the EnumCtrlProcO function 
the lines that read 

else if ((strcmp (str, “Static") == 0) 

&& ((GetWindowLong (hCtrl, GWL-STYLE) 

& WS_B0RDER) 1= 0) 

either have an extra opening paren 
prior to the call to GetWindowLongO, or 
need another closing paren at the end. 

It doesn't make a difference which way 
you fix it, but it is an error if you don't 

3) Finally, in the DlgLooko function, 
the first two lines within the 
WM_NCDESTROY case are identical. I 
would guess that one of these needs to 
read 

DeleteObject ((HBRUSH) 

GetProp (hDlg, "SBr")); 

and I would also guess that if this isn't 
changed that resources will not be 
properly freed. 

After these changes, l was successful 
in getting the code to work properly. I 
thought that if you do receive any 
phone calls, letters, or electronic mes¬ 
sages regarding the article, a little in¬ 
sight might be helpful. 

Thanks for a great magazine. 

Jeff French 
1715 Scranton Ave. 

Front Royal, VA 22630 

I don't believe the STRICT problem 
is a problem, if I understand your com¬ 
plaint. I've been pushing authors to 
make their code compile error-free 
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TUB “ is FASTEST! 



0:41 


PP 


0:19 


0:09 


RCS™ 4.2 PVCS™ TUB’" 3.0 TUB 5.0 


Times are to update a 45K library on a PC/XT. PVCS and TUB 3.0 are 
from Sept 87 PC Tech Journal. MKS RCS 4.2 and TUB 5.0 are newer 


TUB™ is BEST! 

“Do not be fooled by the fact that this is the 
least expensive of the five packages reviewed 
here - TUB has features and power to spare" 

John Rex, Computer Language 

“TUB is a great system " J. Vallino, PC Tech J 

• Full-Featured Version Control for Software 
Professionals. Check-in/out locking. Branching. 
Keywords. Wildcard and list-of-file support. Can 
merge parallel changes and undo intermediate 
revisions. Network and WORM support. Main¬ 
frame compatible deltas for Pansophic, ADR, IBM, 
etc.. Integrates with Opus" MAKE & Slick ” MAKE. 

MS-DOS $139, OS/2 $195 + shipping visa/MC 
5 station LAN license $419 (OS/2 $595), call for other sizes 

BURTON SYSTEMS SOFTWARE 

PO Box 4156, Cary, NC 27519 (919)233-8128 
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IV 

Fast Way To 
Windows 

Let our MS-Windows specialists: 

♦ 

- PORT your existing application 


- DEVELOP a device driver 


- PROVIDE training and support 


DOS, MS-Windows 3.x 
Windows NT 


1-800-344-5468 

4 

*u 
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ET TCP/IP 

programmers! 

GENISYS Comm Pack++ 

GCP++ is a Windows TCP/IP Server, 
providing easy programming access 
to encapsulated TCP/UDP/Telnet/TFTP 
and packetized voice. 

>- Eliminate socket library coding & test 
>- Speed development & debugging 
>- Windows Sockets Compliant 
>- Evaluation kit and source available 
>■ No Royalties! 

We do custom Windows & 
voice/data networking applications! 

GENISYS Comm, Inc. 

314 South Jay Street, Rome, NY 13440 
_ (315) 339-5502 _ 

□ Request 112 on Reader Service Card □ 




Visual Basic, 
BASIC, and PDS 
programmers! 

©eheral Purpose Toolboxes 
fiwpte 
-Screen Design 
Cemmunicotions 
- teer Printing 
. -Sefiriffic Applications 
TSR"s and more! 


Crescent Software offers many tools for 
QuickBASIC, PDS, and Visual Basic. All 
products include complete source code, 
free technical support, and royalties are 
never required! FwumwwtiFHfwMowcMas 

CALL TOLL FREE 

1 800 35 BASIC 


CRESCENT SOFTWARE, INC. 

11 BAILEY AVENUE 
RIDGEFIELD, CT 06877-4505 
2034385300 FAX 203 431 4626 


r ; 

Windows 

Developer Jobs 




Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 
Mac, CASE, Video, Realtime. 
Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 

1-800-231-5920 



Scientific Placement, Inc. 

SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SPI-8, Box 71, San Ramon, CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 926-6188 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 
.CompuServe: 71250,3001; Genie: D.SMALL6 J 


□ Request 335 on Reader Service Card □ 



Wilsoft carries a complete line of bar 
code software and hardware for your 
every need. All major bar code types 
supported. Callthemost experienced 
company in the bar code field today. 
DOS and Xenix/Unix support. Por¬ 
table readers too! 

VISA/MC/AMEX/DISCOVER 

PO Box 6186 

Ft. Lauderdale, FL 33310-6186 
(305) 779-2720 
(305) 763-3096 Fax 
(800) 779-2720 Sales 


□ Request 142 on Reader Service Card □ 


Simtel20 MSDOS CDROM* $24.95 

640 megabytes in 9000+ files. Programming tools. DOS 
utilities, tech docs, comm, bbs, publishing, ham-radio, 
education, and much more. Dated September 1992. 


CICA MS Windows CDROM* $24.95 

Hundreds of MS Windows programs. Utilities, games, 
source code, and programming tools. Dated July 1992. 


Source Code CDROM* $39.95 

XI I R5 and GNU CDROM $39.95 

Info-Mac CDROM* $39.95 

GIFs Galore CDROM $24.95 

OS/2 Archive CDROM* $24.95 

AB20 Amiga CDROM* $24.95 

Garbo MSDOS/MAC CDROM* $24.95 
CDROM Caddies $4.95 


'Shareware programs require separate payment 
to authors if found useful. 


Walnut Creek CDROM 



1547 Palos Verdes Mall 
Suite 260 
Walnut Creek, CA 94596 

+ 1-800-786-9907 

+ 1-510-947-5996 
FAX +1-5 10-947-1644 
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Opt-Tech Sort/Merge 


Extremely fast Sort / Merge / 
Select utility. Run as an MS- 
DOS command or CALL as a 
subroutine. 

Supports most languages and 
filetypes including Btrieve and 
dBase. Unlimited filesizes, mul¬ 
tiple keys and much more! 


MS-DOS, Windows $149. 


OS/2, UNIX $249. 


Opt-Tech Data Processing 

P. O. Box 678 
Zephyr Cove. NV 89448 

(702) 588-3737 
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with STRICT defined and I don’t see 
any good reason to clutter the code 
with conditionals to make it also com¬ 
pile error-free without STRICT defined. 
I would like the code to work with Win¬ 
dows 3.0 at runtime, but at compile 
time I’m willing to require you to have 
Windows 3.1 development tools. 

The parenthesis problem has me 
stumped. My copy of the code does 
not have the error, so I’m not sure how 
it got introduced (but I’ll keep trying to 
figure it out). Thanks for pointing that 
out. Finally, the DeleteObjectQ bug is 
a flat-out bug that nobody else caught; 
we'll fix it. Thanks for the free code 
review and I hope you will continue to 
cast your eagle eye on our code list¬ 
ings! -rib 


Dear Editor: 

1 am renewing Windows/DOS 
Developer’s Journal for only one year. 
Though I have found your magazine 
very useful in the past, I now find few 
articles relevant to the current OS/2 2.0 
operating system. If within the next 
year there are no articles of significance 
within this time, or if I feel there is a 
bias toward Microsoft, I will not renew 
next time. 

Sincerely, 

Tom Twaro 
9575 Dice Rd. 

Freeland, MI 48623 

Well, with the word “Windows” in 
our title, I'm afraid we may lose you at 
the end of the year. If by “bias toward 


Microsoft” you mean Windows and 
Microsoft tools coverage, well, we’ll 
lose you on that count too. A large 
number of our readers program with 
Windows and use Microsoft tools. If, 
on the other hand, you mean you 
detect some sort of slant towards 
Microsoft tools over other vendor's 
tools, that would concern me. One 
reason we've started working to make 
our code listings work with both 
Microsoft and Borland C compilers 
(and Zortech, they ship a product for 
Windows 3.1), is to avoid bias toward 
particular vendors. A large number of 
our readers use non-Microsoft tools 
and we aim to serve them just as well, 
-rib 



Developer's 

Marketplace 


2 tm 

The Art of Visual Basic Programming ™ 

This amazing new book by J. D. Evans, Jr. unlocks 
the secrets of Windows and Visual Basic 
application design and programming. It explains 
Windows design from a unique and easy to 
understand perspective. Smart Objects, Hybrid 
Objects, Control Coupling, Events, Focus, Event 
Triggering, Visibility, Form and Module Code 
Placement, DLL Parameter Passing, Variable 
Scope, Strings, and Structures are described and 
explained. Enlightening allegories and annecdotes 
make this one of the most unusual and informative 
Windows books ever written. This book is the 
Rosetta stone for Windows and Visual Basic! 


Book: $29.95 Companion Disk: $9.95 


ETN Corporation 

RD4 Box 659 Montoursville, PA 17754-9433 
(717) 435-2202 (Sales) (717) 435-2802 (FAX) 
AMEX/MC/VISA/Check/MO/PO/COD 
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NETWORK 

CONTROL 

LIBRARIES 

NETBIOS ROUTINES allows ac¬ 
cess to low-level network func¬ 
tions. Name, session, and 
datagram routines. Wait and no¬ 
wait options. $99 

NETBIOS DLL for Windows $199 

NETWORK MASTER provides 
access to Netware internal func¬ 
tions. Complete network control 
from your compiled programs! $99 

Starlight Software 

P.O. Box 1090 
Wheeling, IL 60090 

(708) 394-0622 _ 
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COM1: - COM4: WITH WINDOWSI 

1,2, OR 4 PORT RS-232 BOARDS 
RS-232 AND RS-422 VERSIONS 
XT AND AT INTERRUPT JUMPERS 
OTHER PRODUCTS INCLUDING LAPTOP 
ADD-ONS 

DELIVERY FROM STOCK 
MADE IN USA 

EXCELLENT TECHNICAL SUPPORT 


SEALEVEL SYSTEMS INC. 
6060X530 
LIBERTY.SC 29657 

803-343-4343 


,5EflLEVEL 
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Basie > C?! 


Basic is better than C when you 
use the ProBas library! Over 900 
routines, most in assembly, let you 
write fast, tight code without 
"C-headaches"! Easy to use, 30 
day money-back guarantee. For 
your FREE 20 page booklet call: 

800-447-9120 ext. 199 

TeraTech 

Dept. W199,100 Park Ave., 

Ste. 360, Rockville MD 20850 
(301)424-3903 Fax:762-8185 
BBS: 762-8184 
"A Supercharger for Basic" - BYTE 
New Visual Basic tools available! 

□ Request 101 on Reader Service Card □ 

^ WindowsCreator ”^ 

anniversary price ^$85 

'•‘create WINDOWS interactively 
'•-no need to write any code 
■•-You PAINT the application,not write!!! 
■•-object-oriented programming using 
standard C-language 
■•■Generated C-code or Smalltalk code 
in seconds!! 

■•• Dialog, window, menu, cursor 

icon, color, brush and attrib. 

editors included. 

■•"interactive functionality linking 
■^application code is separated from 
interface code. Few code lines connect 
application to WINDOWS 3.x interface 

AdamSoft 

13 rue de Crecy,L-1364 Luxembourg 
Fax:+352-494768. VISA accepted 
p&p Europe $10,elsewhere $20 

□ Request 122 on Reader Service Card □ 
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SmartHeap professional memory man- 

to 

£ 

agement library and debugging toolkit (for¬ 
merly OptiMem from Applegate Software) 
is the only tool avail, w/ both fast, optimum 
mem mgmt and comprehensive error de- 


tection. Combination of variable and fixed- 

to 

E 

sizeallocators maximizes both performance 
and flexibility. Incl ANSI C "malloc" and C++ 
"new,” + many other APIs. Fixes selector 

i/i 

V 

consumption, overhead, granularity, frag¬ 
mentation, and DGROUP depletion. Mini¬ 
mizes disk thrashing by localizing data struc- 


tures in their own heaps. Uses just 12K at 

0 

runtime. Detects double-freeing, mem over- 

1—1 

writes, leakage, invalid parameters, wild 

< 

pointers, etc. Programmatic error handling 

1—1 
3 

and heap-walking. Works w/ EXEs, DLLs, & 

device drivers. Bullet-proof reliability, 

0 

"Who's who" user base. 166 page manual. 

0 

No royalties. Source available. $395 

+ 

CALL FOR FREE WHITE PAPER! 

u 

800-441-7822 

1—1 

FAX 206-525-8309 

03 

e 

MicroQuill 

Software Publishing. Inc. 


□ Request 310 on Reader Service Card □ 


FAST TEXT SEARCH 
for C / Windows 


The fastest, easiest and most versatile way to 
add full text search capabilities to your C and 
Windows applications, FAST TEXT SEARCH 
for C is a function library enabling rapid 
searches of both structured and unstructured 
textual data with low overhead/memory 
requirements, low cost and high efficiency. 
Great with CodeBase, SoftC, AccSys, etc. 
No Risk 30 day Money Back Guarantee 

Order - (800) 334-8099 
Only $189.00 

Windows/DOS Developer’s Journal Special includes 
UltraSearch & Free 2 Day Shipping 

DOS (Microsoft, Borland) and OS/2 libraries 
& Windows DLL, royalty free integrator license, 
complete printed documentation, sample 
programs & free technical support. 
VISA/MasterCard/COD/Qualified PO s accepted. 



Index Applications Incorporated 

8546 Broadway, Suite 208 
San Antonio, TX 78217 USA 
512 / 822-4818; fax: 512 / 828-5074 
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Get practical answers to 
your tough marketing questions. 

The Inside True , a bimonthly interactive newsletter 
from The Trachtman Group, Inc. helps software 
companies navigate through the maze of marketing 
issues confronting product launches. 

■ Learn how to fund your marketing program with 
initial direct and OEM sales. 

■ Find out how you can intelligently set the price of 
your new product. 

■ Discover how to get noticed in an increasingly 
crowded market. 

The Inside Trac includes membership to an interac¬ 
tive electronic mail box. 

CALL 800-659-7420 for your first 
no-obligation issue FREE. 

The Trachtman Group, Inc. 

Successful Marketing of PC Software for over 10 years. 
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Speak-EZ 


C++ Class Libraries 
for Windows Multimedia 
Sound Application Development 


• Easily Add Sound Support To 
Windows Applications! 

• Class Libraries provide full support 
for Waveform, MIDI, & CD-ROM 
interfaces. 

• Complete encapsulation of MCI 
audio services. 

• $99 for Static Libs & DLLs, 

$250 w/source. No Runtime Royalties! 


Sound <Hojuzoks 

P.O. Box 6625, Holliston, MA 01746 
(508) 643-2882 
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ADVANCED 

DATABASE ENGINE DLL 

Add advanced database management capabilities to 
your programs with simple function calls. Andsor 
Database Engine for Windows is a DLL you can use 
from C, Visual Basic, and many other languages 
and front-ends. 

• Functions range from simple ISAM file 
operations to full database management. 

• Makes your Windows programs smaller and 
simpler by replacing large sections of code with 
short procedures you create, test, and store in the 
database itself. 

• Ideal for business applications. 

1-800-766-1141 

$ 149 120-day money-back guarantee 

Andsor Research Inc. 

390 Bay St., Suite 2000 
Toronto, Ontario, Canada M5H 2Y2 

(416)245-8073 Fax (416)240-8473 


32-bit Protected Mode 
386 C Graphics Library 

Intel 386/486 C Code Builder 
MetaWare, MicroWay, SVS, 
Watcom & Zortech with 
Phar Lap 3861 ASM 

Mixed Raster/Vector, 
Scalable, Rotatable Font, 
VGA, SVGA, 8514/A, VESA, 

Hercules Graphics Station 
through 1024x768x256 (8-bit), 
640x480x32k (16-bit), 
512x480x16.7m (32-bit), 
WYSIWYG HP-GL/PostScript 
$200 NO ROYALTIES 
FULL SOURCE CODE 
Gary R. Olhoeft 
P.O. Box 10870 Edgemont 
Golden, CO 80401-0620 
303-877-3697 CIS 76665,2021 
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Does your company provide 
tools, products, or services 
for advanced Windows 
programmers? 

Then reach over 27,000 
serious programmers in: 

Windows7POS 

□ DEVELOPER'S JOURNAL 

Call 913-841-1631 today for 
information about advertising 
opportunities in Windows/DOS 
Developer's Journal. 

Advanced. Serious. 
Technical. 

Ed - East Donna - Midwest Edwin - West 


C and C++ DOCUMENTATION 


! AUTOMATED DOCUMENTATION I 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, 
counts comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

• SPECIAL : C-DOC ($199) All 5programs 
integrated as DOS program (<15,000 lines) 

• NEW! C-DOC Professional ($299) 

DOS, OS/2, Windows. 3-ring binder/case. 
Processes 150,000 lines, deterred reports. 

• 30-DAVMoney-back guarantee CALL NOW 


SOFTWARE BLACKSMITH 

6064 St Ives Way, Mississa 
ONT, Canada Voice/Fax ] 
L5N-4M1 Demos/BBS 1 

SINC. 
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|416)-8j 
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Discover why FoxPro, Clipper, 
and dBASE were all written in C. 


^here is a good reason why 
• your database language was 
developed in C. In fact, there 
are many good reasons. 

C code is small. C code is fast. C code is 
portable. C code is flexible. C is the 
language of choice for today's professional 
developer. With the growing complexity of 
database applications, C is a realistic 
alternative. Now with CodeBase 5.0, you 
can have all the functionality, simplicity and 
power of traditional database languages 
together with the benefits of C/C++. 

C speed ■ fast code, true executables... 

FoxPro, Clipper, and dBASE were written 
in C primarily for speed. But those compilers 
don't really compile, they combine imbedded 
language interpreters into your .EXE. Now 
that's slow. For dazzling performance you 
need the true executables of C. With 
CodeBase you get the real thing, C code. 
Consider the following statistics, from the 
publisher of Clipper: 


slower 



remember, those products are all written in 
C. So why do you need to lug all their extra 
code around? You don't. CodeBase is a 
complete DBMS, in C. No fat executables 
stuffed with unused code. No runtime 
modules. No royalties. Just quality C code. 
CodeBase is just what you need. 

C portability - ANSI C/C++ 
on every hardware platform... 

No other language exists on more platforms 
than C/C++. Why rewrite your entire 
application for DOS, Windows, Windows 
NT. OS/2 or UNIX? With CodeBase the 
complete C source code is included, so you 
can port to any platform with an ANSI C or 
C++ compiler. Now and in the future. 

dBASE Compatible data, index 
and memo files... 

You want the industry standard. You need 
compatibility. Sure, dBASE is the standard, 
but every dBASE compatible DBMS 
product uses its own unique index and memo 
file formats. Only CodeBase has them all: 
FoxPro (.cdx), Clipper (.ntx), dBASE IV 
(.mdx) and dBASE III (.ndx). Now it's your 
choice, we're compatible with you. 


dBASE IV 
FoxPro 
Clipper 5 


"Sieve of Erastothenes" 

Benchmark for Prime Number Generation 
Shows C to be incredibly faster! 

C size • small executables, 
no added overhead... 


Announcin: 
CodeBase 

The power of a complete DBMS, the benefits of C 


ing 

5!b 


NEW - Multi-user sharing with 


laring witn 
dBASE... 


FoxPro, Clipper and i 

Now your multi-user C/C++ programs can 
share data, index and memo files at the 
same time as concurrently running FoxPro, 
Clipper and dBASE programs. No 
incompatibilities. No waiting. 


01992 Sequitcr Software Inc. All rights r 


NEW - Queries & Relations 
1000 times faster... 

CodeBase 5.0 now lets you query related 

■ed. CodeBase is a trademark of Sequiler Software Inc. All other trade names referenced herein are property of their respective companies. MAdvertising by Mict 
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FoxPro, Clipper and dBASE would like you 
to believe you need their entire development 
system to build database applications. But 


data files with any logical dBASE expression. 
Our new Bit Optimization Technology 
(similar to FoxPro's Rushmore technology) 
uses index files to return a query on a 1/2 
million record data file in just a second. 
Automatically take advantage of this query 
performance by using our new CodeReporter: 



Eile Align Database Coups Global Print Query Styles Help 

[Product Sales Sumn 

Product Sales Summary 

Month ot Nov. 1992 

Product Quantity Value 

Database 63 *25.137 00 

Spreadsheet $8 121.866 00 

Monthly Summary 121 847.003.00 

Month: Header: Objects: 5: Height: 48.0 Points 

M'o'ntt of.l IW LIHI 

IPtodurl [Quantity! IVaM 

Body: Header: Objects: 3; Height: 14.0 Points 

Month: Footer: Objects: 4: Height: 48.0 Points 

Month ot: Dec. 1992 

Product Quantity Value 

Database 62 824.86200 

Spreed Sheet 53 819.875.00 

Monthly Summary 115 944.737.00 

[Monthly Summit MTOTAl. MDOLUt 


Summary: Objects: 3: Height: 36.0 Points 

Summit [TOTAL 1 DOLLAR! 




Summary 236 $91,740.00 

To use CodeReporter, 



simply draw your report, then include it in any 
program you write. Call 403/437-2410 now for 
your FREE working model of CodeReporter. 

New - Design complex reports 
in just minutes... 

Our new CodeReporter takes the painstaking 
work out of reports. Now simply design and 
draw reports interactively under Windows 3.1, 
then print or display them from any DOS, 
Windows or UNIX application. 

SPECIAL - FREE CodeReporter 

Order CodeBase 5 before Feb. 28, 1993 and 
receive CodeReporter for free! This offer 
includes our no-risk, 90-day money back 
guarantee, so order today! 


GoefeSas® S.O 

The C/C++ Library for DataBase Management 

Call Now 
403 - 437-2410 



38MSSS" *EI«I 


SEQUITER II FAX 403*436*2999 

SOFTWARE INC. Ill Europe 33.20.24.20.14 

#209,9644-54 AVE., EDMONTON, AB, CANADA T6E-5V1 


































New BOUNDS-CHECKER 2.0 



Welcome to the age of 
automated memory/heap protection! 

NEW BOUNDS-CHECKER 2.0 is the sobf complete solution to MS-DOS 
memory sand heap corruption problems. 

BOUND-CHECKER 2.0 is a single, easy to use utility that automatically 
detects problems in your programs heap, stack or data segment and 
finds illegal memory accesses outside of your program or in your code, 
In one step, you can quickly and easily flush out some of the most 
insidious bugs that you regularly encounter as a DOS programmer. 


• New 2.0 Features • 

• Now works with 3rd party memory managers 

• Heap, stack and data segment checking 

• Smart Mode decides the legitimacy of an access automatically 

• No need to see assembly code : call stack lets you view source 
of calling routines. 

• New Auto Log mode (BC doesn't pop up) 

• Supports C7.0 & Behind 3.1 & VROOM 

Order NOW! On/y $199 


Using BOUNDS-CHECKER 2.0 is simple, there are no changes to be made 
to your source in any way, and no linking of code or macros into your 
executable. When a bug is found, BOUNDS-CHECKER pops up showing 
you precisely where the problem is. 

One of its innovative NEW features is Smart Mode. Smart Mode uses a 
built-in knowledge base to automatically determine if an out-of-bounds 
access is legitimate. This eliminates any complex decisions on your part, 
resulting in more power and flexibility than you may have thought 
possible. 

Don't take unnecessary risks with your program or your customers. 
BOUNDS-CHECK before you ship with NEW version 2.0. 


For even more debugging power, BOUNDS-CHECKER 2.0 
integrates with our award-winning Soft-ICE debugger which fea¬ 
tures powerful 386/486 based breakpoints. Equipped with this 
formidable combination, your de-bugging arsenal is prepared for 
any surprise attack of the DOS Nasties. 

Soft-ICE...$386 

BOUNDS-CHECKER 2.0 & Soft-ICE Bundle Only...$499 

BOUNDS-CHECKER AND SOFT-ICE ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES, INC. 


We're making C a Safe Language! 


Call (603) 889-2386 
fax (603) 889-1135 


N 

lu-] 

Meea 

RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 

P.O. Box 7780 

Nashua, NH 03060-7780 U.S.A. 

^TECHNOLOGIES INC 

24 HOUR BBS 
603-595-0386 
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